From 3634675e0d179b770fd374c7211aec81961567b4 Mon Sep 17 00:00:00 2001 From: Derick Rethans Date: Mon, 11 Mar 2002 07:30:22 +0000 Subject: [PATCH] - Restructuring partintros git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@72714 c90b9560-bf6c-de11-be94-00142212c4b1 --- functions/array.xml | 61 +++++- functions/bc.xml | 47 ++++- functions/bzip2.xml | 65 ++++-- functions/crack.xml | 70 +++++-- functions/ctype.xml | 5 +- functions/mcrypt.xml | 472 +++++++++++++++---------------------------- functions/mysql.xml | 302 ++++++++++++++++----------- functions/pcre.xml | 127 +++++++----- 8 files changed, 619 insertions(+), 530 deletions(-) diff --git a/functions/array.xml b/functions/array.xml index 7f64b1a307..8fd8614e4e 100644 --- a/functions/array.xml +++ b/functions/array.xml @@ -1,25 +1,66 @@ - + Array Functions Arrays + - + These functions allow you to interact with and manipulate arrays in various ways. Arrays are essential for storing, managing, and operating on sets of variables. - - + + Simple and multi-dimensional arrays are supported, and may be either user created or created by another function. There are specific database handling functions for populating arrays from database queries, and several functions return arrays. - - - Please see the Arrays - section of the manual for a detailed explanation of how arrays are - implemented and used in PHP. - + + + Please see the Arrays + section of the manual for a detailed explanation of how arrays are + implemented and used in PHP. + + +
+ Requirements + + These functions are available as part of the standard module, which is + always available. + +
+ +
+ Installation + + There is no installation needed to use these functions, they are part of + the PHP core. + +
+ +
+ Runtime Configuration + + This extension does not define any configuration directives. + +
+ +
+ Resource types + + This extension does not define any resource types. + +
+ +
+ Predefined constants + + CASE_UPPER and CASE_LOWER are + used with the array_change_key_case function. They + respectively are used for chaning a string to upper case or lower case. + +
+ See also is_array, explode, implode, split, diff --git a/functions/bc.xml b/functions/bc.xml index 92abe91030..911fe3bb2c 100644 --- a/functions/bc.xml +++ b/functions/bc.xml @@ -1,21 +1,17 @@ - + BCMath Arbitrary Precision Mathematics Functions BC math - + For arbitrary precision mathematics PHP offers the Binary Calculator which supports numbers of any size and precision, represented as strings. - - In PHP 4, these functions are only available if PHP was configured with - . - In PHP 3, these functions are only available if PHP was not configured with - . - - + +
+ Requirements Due to changes in the licensing, the BCMATH library is distributed separate from the standard PHP source distribution. @@ -24,7 +20,38 @@ file README.BCMATH in the PHP distribution for more information. - +
+ +
+ Installation + + In PHP 4, these functions are only available if PHP was configured with + . + In PHP 3, these functions are only available if PHP was not configured with + . + +
+ +
+ Runtime Configuration + + This extension does not define any configuration directives. + +
+ +
+ Resource types + + This extension does not define any resource types. + +
+ +
+ Predefined constants + + This extension does not define any constants. + +
diff --git a/functions/bzip2.xml b/functions/bzip2.xml index b99ace6cf0..f637200ed8 100644 --- a/functions/bzip2.xml +++ b/functions/bzip2.xml @@ -1,23 +1,56 @@ - + Bzip2 Compression Functions Bzip2 - - - This module uses the functions of the bzip2 library by Julian Seward to - transparently read and write bzip2 (.bz2) compressed files. - - - Bzip2 support in PHP is not enabled by default. You will need to - use the --with-bz2 configuration - option when compiling PHP to enable bzip2 support. This module - requires bzip2/libbzip2 version >= 1.0.x. - - - Small code example + + + The bzip2 functions are used to transparently read and write bzip2 (.bz2) + compressed files. + + +
+ Requirements + + This module uses the functions of the bzip2 library by Julian Seward + +
+ +
+ Installation + + Bzip2 support in PHP is not enabled by default. You will need to + use the --with-bz2 configuration + option when compiling PHP to enable bzip2 support. This module + requires bzip2/libbzip2 version >= 1.0.x. + +
+ +
+ Runtime Configuration + + This extension does not define any configuration directives. + +
+ +
+ Resource types + + This extension does not define any resource types. + +
+ +
+ Predefined constants + + This extension does not define any constants. + +
+ +
+ Example This example opens a temporary file and writes a test string to it, then prints out the contents of the file. @@ -55,7 +88,7 @@ bzclose($bz); ]]> - +
diff --git a/functions/crack.xml b/functions/crack.xml index a7b9829a6c..6d667ec670 100644 --- a/functions/crack.xml +++ b/functions/crack.xml @@ -1,29 +1,60 @@ - + Crack functions Crack functions - - These functions allow you to use the CrackLib library to test the 'strength' - of a password. In order to use these functions, you must compile PHP with - Crack support by using the - option. - - - More information regarding CrackLib along with the library can be found at - &url.crack;. - - - Cracklib is useful in testing the 'strength' of a password that checks - length, use of upper and lower case and a check against the specified CrackLib - dictionary. CrackLib will also give helpful diagnostic messages that will - help 'strengthen' the password. - + + These functions allow you to use the CrackLib library to test the + 'strength' of a password. The 'strength' of a password is tested by that + checks length, use of upper and lower case and checked against the + specified CrackLib dictionary. CrackLib will also give helpful diagnostic + messages that will help 'strengthen' the password. + + +
+ Requirements - This example shows how to open a CrackLib dictionary, test a given password, - retrieve any diagnostic messages, and close the dictionary. + More information regarding CrackLib along with the library can be found at + &url.crack;. + +
+ +
+ Installation + + In order to use these functions, you must compile PHP with Crack support + by using the option. + +
+ +
+ Runtime Configuration + + This extension does not define any configuration directives. + +
+ +
+ Resource types + + This extension does not define any resource types. + +
+ +
+ Predefined constants + + This extension does not define any constants. + +
+ +
+ Example + + This example shows how to open a CrackLib dictionary, test a given + password, retrieve any diagnostic messages, and close the dictionary. CrackLib example @@ -55,7 +86,6 @@ crack_closedict($dictionary); - crack_opendict diff --git a/functions/ctype.xml b/functions/ctype.xml index 367818617a..8d51cd173a 100644 --- a/functions/ctype.xml +++ b/functions/ctype.xml @@ -1,11 +1,10 @@ - + Character type functions ctype - The functions provided by this extension check whether a character or string falls into a certain character class according to the @@ -26,7 +25,7 @@ return &false; immediately. -
+
Requirements None besides functions from the standard C library which are diff --git a/functions/mcrypt.xml b/functions/mcrypt.xml index 8c8e3e059c..274f96f1e3 100644 --- a/functions/mcrypt.xml +++ b/functions/mcrypt.xml @@ -1,36 +1,17 @@ - + Mcrypt Encryption Functions mcrypt - - These functions work using mcrypt. - - + This is an interface to the mcrypt library, which supports a wide variety of block algorithms such as DES, TripleDES, Blowfish (default), 3-WAY, SAFER-SK64, SAFER-SK128, TWOFISH, TEA, RC2 and GOST in CBC, OFB, CFB and ECB cipher modes. Additionally, it supports RC6 and IDEA which are considered "non-free". - - If you linked against libmcrypt 2.4.x, the following additional - block algorithms are supported: CAST, LOKI97, RIJNDAEL, SAFERPLUS, - SERPENT and the following stream ciphers: ENIGMA (crypt), PANAMA, - RC4 and WAKE. With libmcrypt 2.4.x another cipher mode is also - available; nOFB. - - - To use it, download libmcrypt-x.x.tar.gz from here and follow the included - installation instructions. You need to compile PHP with the - parameter to - enable this extension. Make sure you compile libmcrypt with the - option . - Mcrypt can be used to encrypt and decrypt using the above mentioned ciphers. If you linked against libmcrypt-2.2.x, the @@ -77,295 +58,166 @@ mcrypt_generic_end ($td); This example will give you the encrypted data as a string in $encrypted_data. - - Mcrypt can operate in four block cipher modes (CBC, OFB, CFB, and - ECB). If linked against libmcrypt-2.4.x mcrypt can also operate - in the block cipher mode nOFB and in STREAM mode. Then there are - also constants in the form MCRYPT_MODE_mode for use with several - functions. We will outline the normal use for each of these modes. - For a more complete reference and discussion see - &book.applied.cryptography;. - - - - ECB (electronic codebook) is suitable for random data, such as - encrypting other keys. Since data there is short and random, - the disadvantages of ECB have a favorable negative - effect. - - - - - CBC (cipher block chaining) is especially suitable for - encrypting files where the security is increased over ECB - significantly. - - - - - CFB (cipher feedback) is the best mode for encrypting byte - streams where single bytes must be encrypted. - - - - - OFB (output feedback, in 8bit) is comparable to CFB, but - can be used in applications where error propagation cannot - be tolerated. It's insecure (because it operates in 8bit - mode) so it is not recommended to use it. - - - - - nOFB (output feedback, in nbit) is comparable to OFB, but - more secure because it operates on the block size of the - algorithm. - - - - - STREAM is an extra mode to include some stream algorithms - like WAKE or RC4. - - - - - - PHP does not support encrypting/decrypting bit streams - currently. As of now, PHP only supports handling of strings. - - - For a complete list of supported ciphers, see the defines at the - end of mcrypt.h. The general rule with the - mcrypt-2.2.x API is that you can access the cipher from PHP with - MCRYPT_ciphername. With the mcrypt-2.4.x API these constants also - work, but it is possible to specify the name of the cipher as - a string with a call to mcrypt_module_open. - - - Here is a short list of ciphers which are currently supported by - the mcrypt extension. If a cipher is not listed here, but is - listed by mcrypt as supported, you can safely assume that this - documentation is outdated. - - - - MCRYPT_3DES - - - - - MCRYPT_ARCFOUR_IV (libmcrypt 2.4.x only) - - - - - MCRYPT_ARCFOUR (libmcrypt 2.4.x only) - - - - - MCRYPT_BLOWFISH - - - - - MCRYPT_CAST_128 - - - - - MCRYPT_CAST_256 - - - - - MCRYPT_CRYPT - - - - - MCRYPT_DES - - - - - MCRYPT_DES_COMPAT (libmcrypt 2.2.x only) - - - - - MCRYPT_ENIGMA (libmcrypt 2.4.x only, alias for MCRYPT_CRYPT) - - - - - MCRYPT_GOST - - - - - MCRYPT_IDEA (non-free) - - - - - MCRYPT_LOKI97 (libmcrypt 2.4.x only) - - - - - MCRYPT_MARS (libmcrypt 2.4.x only, non-free) - - - - - MCRYPT_PANAMA (libmcrypt 2.4.x only) - - - - - MCRYPT_RIJNDAEL_128 (libmcrypt 2.4.x only) - - - - - MCRYPT_RIJNDAEL_192 (libmcrypt 2.4.x only) - - - - - MCRYPT_RIJNDAEL_256 (libmcrypt 2.4.x only) - - - - - MCRYPT_RC2 - - - - - MCRYPT_RC4 (libmcrypt 2.2.x only) - - - - - MCRYPT_RC6 (libmcrypt 2.4.x only) - - - - - MCRYPT_RC6_128 (libmcrypt 2.2.x only) - - - - - MCRYPT_RC6_192 (libmcrypt 2.2.x only) - - - - - MCRYPT_RC6_256 (libmcrypt 2.2.x only) - - - - - MCRYPT_SAFER64 - - - - - MCRYPT_SAFER128 - - - - - MCRYPT_SAFERPLUS (libmcrypt 2.4.x only) - - - - - MCRYPT_SERPENT (libmcrypt 2.4.x only) - - - - - MCRYPT_SERPENT_128 (libmcrypt 2.2.x only) - - - - - MCRYPT_SERPENT_192 (libmcrypt 2.2.x only) - - - - - MCRYPT_SERPENT_256 (libmcrypt 2.2.x only) - - - - - MCRYPT_SKIPJACK (libmcrypt 2.4.x only) - - - - - MCRYPT_TEAN (libmcrypt 2.2.x only) - - - - - MCRYPT_THREEWAY - - - - - MCRYPT_TRIPLEDES (libmcrypt 2.4.x only) - - - - - MCRYPT_TWOFISH (for older mcrypt 2.x versions, or mcrypt 2.4.x ) - - - - - MCRYPT_TWOFISH128 (TWOFISHxxx are available in newer 2.x versions, but not in the 2.4.x versions) - - - - - MCRYPT_TWOFISH192 - - - - - MCRYPT_TWOFISH256 - - - - - MCRYPT_WAKE (libmcrypt 2.4.x only) - - - - - MCRYPT_XTEA (libmcrypt 2.4.x only) - - - - - - You must (in CFB and OFB mode) or can (in CBC mode) supply an - initialization vector (IV) to the respective cipher function. The - IV must be unique and must be the same when - decrypting/encrypting. With data which is stored encrypted, you - can take the output of a function of the index under which the - data is stored (e.g. the MD5 key of the filename). - Alternatively, you can transmit the IV together with the encrypted - data (see chapter 9.3 of &book.applied.cryptography; for a - discussion of this topic). - + +
+ Requirements + + These functions work using mcrypt. + + + If you linked against libmcrypt 2.4.x, the following additional + block algorithms are supported: CAST, LOKI97, RIJNDAEL, SAFERPLUS, + SERPENT and the following stream ciphers: ENIGMA (crypt), PANAMA, + RC4 and WAKE. With libmcrypt 2.4.x another cipher mode is also + available; nOFB. + +
+ +
+ Installation + + To use it, download libmcrypt-x.x.tar.gz from here and follow the included + installation instructions. You need to compile PHP with the + parameter to + enable this extension. Make sure you compile libmcrypt with the + option . + +
+ +
+ Runtime Configuration + + + +
+ +
+ Resource types + + This extension does not define any resource types. + +
+ +
+ Predefined constants + + + Mcrypt can operate in four block cipher modes (CBC, OFB, CFB, and + ECB). If linked against libmcrypt-2.4.x mcrypt can also operate + in the block cipher mode nOFB and in STREAM mode. Below you find a list + with all supported encryption modes together with the constants that are + defines for the encryption mode. For a more complete reference and + discussion see &book.applied.cryptography;. + + + + MCRYPT_MODE_ECB (electronic codebook) is suitable for random data, + such as encrypting other keys. Since data there is short and random, + the disadvantages of ECB have a favorable negative effect. + + + + + MCRYPT_MODE_CBC (cipher block chaining) is especially suitable for + encrypting files where the security is increased over ECB + significantly. + + + + + MCRYPT_MODE_CFB (cipher feedback) is the best mode for encrypting byte + streams where single bytes must be encrypted. + + + + + MCRYPT_MODE_OFB (output feedback, in 8bit) is comparable to CFB, but + can be used in applications where error propagation cannot + be tolerated. It's insecure (because it operates in 8bit + mode) so it is not recommended to use it. + + + + + MCRYPT_MODE_NOFB (output feedback, in nbit) is comparable to OFB, but + more secure because it operates on the block size of the algorithm. + + + + + MCRYPT_MODE_STREAM is an extra mode to include some stream algorithms + like WAKE or RC4. + + + + + + + Here is a list of ciphers which are currently supported by the mcrypt + extension. For a complete list of supported ciphers, see the defines at + the end of mcrypt.h. The general rule with the + mcrypt-2.2.x API is that you can access the cipher from PHP with + MCRYPT_ciphername. With the mcrypt-2.4.x API these constants also work, + but it is possible to specify the name of the cipher as a string with a + call to mcrypt_module_open. + + MCRYPT_3DES + MCRYPT_ARCFOUR_IV (libmcrypt 2.4.x only) + MCRYPT_ARCFOUR (libmcrypt 2.4.x only) + MCRYPT_BLOWFISH + MCRYPT_CAST_128 + MCRYPT_CAST_256 + MCRYPT_CRYPT + MCRYPT_DES + MCRYPT_DES_COMPAT (libmcrypt 2.2.x only) + MCRYPT_ENIGMA (libmcrypt 2.4.x only, alias for MCRYPT_CRYPT) + MCRYPT_GOST + MCRYPT_IDEA (non-free) + MCRYPT_LOKI97 (libmcrypt 2.4.x only) + MCRYPT_MARS (libmcrypt 2.4.x only, non-free) + MCRYPT_PANAMA (libmcrypt 2.4.x only) + MCRYPT_RIJNDAEL_128 (libmcrypt 2.4.x only) + MCRYPT_RIJNDAEL_192 (libmcrypt 2.4.x only) + MCRYPT_RIJNDAEL_256 (libmcrypt 2.4.x only) + MCRYPT_RC2 + MCRYPT_RC4 (libmcrypt 2.2.x only) + MCRYPT_RC6 (libmcrypt 2.4.x only) + MCRYPT_RC6_128 (libmcrypt 2.2.x only) + MCRYPT_RC6_192 (libmcrypt 2.2.x only) + MCRYPT_RC6_256 (libmcrypt 2.2.x only) + MCRYPT_SAFER64 + MCRYPT_SAFER128 + MCRYPT_SAFERPLUS (libmcrypt 2.4.x only) + MCRYPT_SERPENT(libmcrypt 2.4.x only) + MCRYPT_SERPENT_128 (libmcrypt 2.2.x only) + MCRYPT_SERPENT_192 (libmcrypt 2.2.x only) + MCRYPT_SERPENT_256 (libmcrypt 2.2.x only) + MCRYPT_SKIPJACK (libmcrypt 2.4.x only) + MCRYPT_TEAN (libmcrypt 2.2.x only) + MCRYPT_THREEWAY + MCRYPT_TRIPLEDES (libmcrypt 2.4.x only) + MCRYPT_TWOFISH (for older mcrypt 2.x versions, or mcrypt 2.4.x ) + MCRYPT_TWOFISH128 (TWOFISHxxx are available in newer 2.x versions, but not in the 2.4.x versions) + MCRYPT_TWOFISH192 + MCRYPT_TWOFISH256 + MCRYPT_WAKE (libmcrypt 2.4.x only) + MCRYPT_XTEA (libmcrypt 2.4.x only) + + + + You must (in CFB and OFB mode) or can (in CBC mode) supply an + initialization vector (IV) to the respective cipher function. The + IV must be unique and must be the same when + decrypting/encrypting. With data which is stored encrypted, you + can take the output of a function of the index under which the + data is stored (e.g. the MD5 key of the filename). + Alternatively, you can transmit the IV together with the encrypted + data (see chapter 9.3 of &book.applied.cryptography; for a + discussion of this topic). + +
diff --git a/functions/mysql.xml b/functions/mysql.xml index f4f06848aa..47abf49d01 100644 --- a/functions/mysql.xml +++ b/functions/mysql.xml @@ -1,126 +1,200 @@ - + MySQL Functions MySQL + - - These functions allow you to access MySQL database servers. In - order to have these functions available, you must compile PHP - with MySQL support by using the - option. If you - use this option without specifying the path to MySQL, PHP will - use the built-in MySQL client libraries. Users who run other - applications that use MySQL (for example, running PHP 3 and PHP 4 - as concurrent apache modules, or auth-mysql) should always - specify the path to MySQL: - . - This will force PHP to use the client libraries installed by - MySQL, avoiding any conflicts. - - + + These functions allow you to access MySQL database servers. More information about MySQL can be found at &url.mysql;. - - - Documentation for MySQL can be found at &url.mysql.docs;. - - - The behaviour of the MySQL functions is affected by settings in the global - configuration file. - - <link linkend="ini.sect.mysql">MySQL Configuration </link> Options - - - - Name - Default - Changeable - - - - - mysql.allow_persistent - "On" - PHP_INI_SYSTEM - - - mysql.max_persistent - "-1" - PHP_INI_SYSTEM - - - mysql.max_links - "-1" - PHP_INI_SYSTEM - - - mysql.default_port - NULL - PHP_INI_ALL - - - mysql.default_socket - NULL - PHP_INI_ALL - - - mysql.default_host - NULL - PHP_INI_ALL - - - mysql.default_user - NULL - PHP_INI_ALL - - - -
- For further details and definition of the PHP_INI_* constants see ini_set. - This simple example shows how to connect, execute a query, print - resulting rows and disconnect from a MySQL database. - - MySQL extension overview example - -\n"; -while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) { - print "\t\n"; - foreach ($line as $col_value) { - print "\t\t$col_value\n"; - } - print "\t\n"; -} -print "\n"; - -// Free resultset -mysql_free_result($result); - -// Closing connection -mysql_close($link); -?> -]]> - - + Documentation for MySQL can be found at &url.mysql.docs;. + +
+ Requirements + + In order to have these functions available, you must compile PHP with + MySQL support + +
+ +
+ Installation + + By using the configuration + option you enable PHP to access MySQL databases. If you use this option + without specifying the path to MySQL, PHP will use the built-in MySQL + client libraries. With PHP4 MySQL support is always eanbled; if you don't + specify the configure option, the bundled libraries are used. Users who + run other applications that use MySQL (for example, running PHP 3 and PHP + 4 as concurrent apache modules, or auth-mysql) should always specify the + path to MySQL: . This will force + PHP to use the client libraries installed by MySQL, avoiding any + conflicts. + +
+ +
+ Runtime Configuration + + The behaviour of the MySQL functions is affected by settings in the + global configuration file. + + <link linkend="ini.sect.mysql">MySQL Configuration</link> Options + + + + Name + Default + Changeable + + + + + mysql.allow_persistent + "On" + PHP_INI_SYSTEM + + + mysql.max_persistent + "-1" + PHP_INI_SYSTEM + + + mysql.max_links + "-1" + PHP_INI_SYSTEM + + + mysql.default_port + NULL + PHP_INI_ALL + + + mysql.default_socket + NULL + PHP_INI_ALL + + + mysql.default_host + NULL + PHP_INI_ALL + + + mysql.default_user + NULL + PHP_INI_ALL + + + +
+ For further details and definition of the PHP_INI_* constants see + ini_set. + +
+ +
+ Resource types + + There are two resource types used in the MySQL module. The first one isis + is the link identifier for a database connection, the second a resource + which helds the result of a query. + +
+ +
+ Predefined constants + + The function mysql_fetch_array uses a constant for + the different types of result arrays. The following constants are + defined: + + ncurses color constants + + + + constant + meaning + + + + + MYSQL_ASSOC + + Columns are returned into the array having the fieldname as the array + index. + + + + MYSQL_BOTH + + Columns are returned into the array having both a numerical index + and the fieldname as the array index. + + + + MYSQL_NUM + + Columns are returned into the array having a numerical index to the + fields. This index starts with 0, the first field in the result. + + + + +
+ +
+ +
+ Examples + + This simple example shows how to connect, execute a query, print + resulting rows and disconnect from a MySQL database. + + MySQL extension overview example + + \n"; + while ($line = mysql_fetch_array($result, MYSQL_ASSOC)) { + print "\t\n"; + foreach ($line as $col_value) { + print "\t\t$col_value\n"; + } + print "\t\n"; + } + print "\n"; + + // Free resultset + mysql_free_result($result); + + // Closing connection + mysql_close($link); + ?> + ]]> + + + +
@@ -1877,7 +1951,7 @@ $result = mysql_query("SELECT my_col FROM my_tbl") execution. - See also: mysql_num_rows + See also: mysql_num_rows, mysql_affected_rows, mysql_unbuffered_query, mysql_free_result, diff --git a/functions/pcre.xml b/functions/pcre.xml index 1a55f8090b..96a6c84df4 100644 --- a/functions/pcre.xml +++ b/functions/pcre.xml @@ -1,17 +1,11 @@ - + Regular Expression Functions (Perl-Compatible) PCRE - - - PHP also supports regular expressions using a POSIX-extended syntax - using the POSIX-extended regex functions.. - - - + The syntax for patterns used in these functions closely resembles Perl. The expression should be enclosed in the delimiters, a forward slash (/), for example. Any character can be used for @@ -26,50 +20,89 @@ See Pattern Modifiers. - - Examples of valid patterns - - /<\/\w+>/ - |(\d{3})-\d+|Sm - /^(?i)php[34]/ - {^\s+(\s+)?$} - - + PHP also supports regular expressions using a POSIX-extended syntax + using the POSIX-extended regex functions.. - - - Examples of invalid patterns - - - - /href='(.*)' - missing ending delimiter - - - - - /\w+\s*\w+/J - unknown modifier 'J' - - - - - 1-\d3-\d3-\d4| - missing starting delimiter - - - - - - - - The Perl-compatible regular expression functions are available in - PHP 4 and in PHP 3.0.9 and up. - - + +
+ Requirements + Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and copyright by the University of Cambridge, England. It is available at &url.pcre;. - - + +
+ +
+ Installation + + Beginning with PHP 4.2.0 this function are enabled by default. + For older versions you have to configure and compile PHP + with in order + to use these functions. You can disable the pcre functions with . + +
+ +
+ Runtime Configuration + + This extension does not define any configuration directives. + +
+ +
+ Resource types + + This extension does not define any resource types. + +
+ +
+ Predefined constants + + This extension does not define any constants. + +
+ +
+ Examples + + + Examples of valid patterns + + /<\/\w+>/ + |(\d{3})-\d+|Sm + /^(?i)php[34]/ + {^\s+(\s+)?$} + + + + + + Examples of invalid patterns + + + + /href='(.*)' - missing ending delimiter + + + + + /\w+\s*\w+/J - unknown modifier 'J' + + + + + 1-\d3-\d3-\d4| - missing starting delimiter + + + + + +
+