PHP: PHP Options&Information - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

assert_options canWrite

Last updated: Fri, 26 Jan 2007

view this page in

# CXXI. PHP Options&Information

# Введение

This functions enable you to get a lot of information about PHP itself, e.g. runtime configuration, loaded extensions, version and much more. You'll also find functions to set options for your running PHP. The probably best known function of PHP - phpinfo() - can be found here.

# Требования

Эти функции всегда доступны.

# Установка

Для использования этих функций не требуется проведение установки, поскольку они являются частью ядра PHP.

# Настройка во время выполнения

Поведение этих функций зависит от установок в `php.ini`.

Таблица 1. PHP Options/Inf Configuration Options

Name | Default | Changeable | Changelog
--- | --- | --- | ---
assert.active | "1" | PHP_INI_ALL |
assert.bail | "0" | PHP_INI_ALL |
assert.warning | "1" | PHP_INI_ALL |
assert.callback | NULL | PHP_INI_ALL |
assert.quiet_eval | "0" | PHP_INI_ALL |
enable_dl | "1" | PHP_INI_SYSTEM |
max_execution_time | "30" | PHP_INI_ALL |
max_input_time | "-1" | PHP_INI_PERDIR | Available since PHP 4.3.0.
magic_quotes_gpc | "1" | PHP_INI_PERDIR | PHP_INI_ALL in PHP <= 4.2.3.
magic_quotes_runtime | "0" | PHP_INI_ALL |

Для подробного описания констант PHP_INI_*, обратитесь к документации функции ini_set().

Краткое разъяснение конфигурационных директив.

`assert.active` boolean

  Enable assert() evaluation.

`assert.bail` boolean

  Terminate script execution on failed assertions.

`assert.warning` boolean

  Issue a PHP warning for each failed assertion.

`assert.callback` string

  user function to call on failed assertions

`assert.quiet_eval` boolean

  Use the current setting of error_reporting() during assertion expression evaluation. If enabled, no errors are shown (implicit error_reporting(0)) while evaluation. If disabled, errors are shown according to the settings of error_reporting()

`enable_dl` boolean

  This directive is really only useful in the Apache module version of PHP. You can turn dynamic loading of PHP extensions with dl() on and off per virtual server or per directory.

  The main reason for turning dynamic loading off is security. With dynamic loading, it's possible to ignore all open_basedir restrictions. The default is to allow dynamic loading, except when using безопасный режим. In безопасный режим, it's always impossible to use dl().

`max_execution_time` integer

  This sets the maximum time in seconds a script is allowed to run before it is terminated by the parser. This helps prevent poorly written scripts from tying up the server. The default setting is `30`.

  The maximum execution time is not affected by system calls, stream operations etc. Please see the set_time_limit() function for more details.

  You can not change this setting with ini_set() when running in безопасный режим. The only workaround is to turn off safe mode or by changing the time limit in the `php.ini`.

  Your webserver can have other timeouts. E.g. Apache has `Timeout` directive, IIS has CGI timeout function, both default to 300 seconds. See the webserver documentation for meaning of it.

`max_input_time` integer

  This sets the maximum time in seconds a script is allowed to parse input data, like POST, GET and file uploads.

`magic_quotes_gpc` boolean

  Sets the magic_quotes state for GPC (Get/Post/Cookie) operations. When magic_quotes are on, all ' (single-quote), " (double quote), \ (backslash) and NUL's are escaped with a backslash automatically.

  > Замечание: If the magic_quotes_sybase directive is also ON it will completely override magic_quotes_gpc. Having both directives enabled means only single quotes are escaped as ''. Double quotes, backslashes and NUL's will remain untouched and unescaped.

  See also get_magic_quotes_gpc()

`magic_quotes_runtime` boolean

  If `magic_quotes_runtime` is enabled, most functions that return data from any sort of external source including databases and text files will have quotes escaped with a backslash. If magic_quotes_sybase is also on, a single-quote is escaped with a single-quote instead of a backslash.

# Типы ресурсов

Данное расширение не определяет никакие типы ресурсов.

# Предопределенные константы

Перечисленные ниже константы всегда доступны как часть ядра PHP.

Таблица 2. Pre-defined phpcredits() constants

Constant | Value | Description
--- | --- | ---
CREDITS_GROUP | 1 | A list of the core developers
CREDITS_GENERAL | 2 | General credits: Language design and concept, PHP authors and SAPI module.
CREDITS_SAPI | 4 | A list of the server API modules for PHP, and their authors.
CREDITS_MODULES | 8 | A list of the extension modules for PHP, and their authors.
CREDITS_DOCS | 16 | The credits for the documentation team.
CREDITS_FULLPAGE | 32 | Usually used in combination with the other flags. Indicates that a complete stand-alone HTML page needs to be printed including the information indicated by the other flags.
CREDITS_QA | 64 | The credits for the quality assurance team.
CREDITS_ALL | -1 | All the credits, equivalent to using: CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + CREDITS_QA CREDITS_FULLPAGE. It generates a complete stand-alone HTML page with the appropriate tags. This is the default value.

Таблица 3. phpinfo() constants

Constant | Value | Description
--- | --- | ---
INFO_GENERAL | 1 | The configuration line, `php.ini` location, build date, Web Server, System and more.
INFO_CREDITS | 2 | PHP Credits. See also phpcredits().
INFO_CONFIGURATION | 4 | Current Local and Master values for PHP directives. See also ini_get().
INFO_MODULES | 8 | Loaded modules and their respective settings.
INFO_ENVIRONMENT | 16 | Environment Variable information that's also available in `$_ENV`.
INFO_VARIABLES | 32 | Shows all predefined variables from EGPCS (Environment, GET, POST, Cookie, Server).
INFO_LICENSE | 64 | PHP License information. See also the license faq.
INFO_ALL | -1 | Shows all of the above. This is the default value.

`ASSERT_ACTIVE` (integer)

`ASSERT_CALLBACK` (integer)

`ASSERT_BAIL` (integer)

`ASSERT_WARNING` (integer)

`ASSERT_QUIET_EVAL` (integer)

add a note User Contributed Notes
PHP Options&Information
gilthansNOSPAAM at gmailSPAAMBLOCK dot com
15-Mar-2005 05:04
`Note: when magic_quotes_gpc is ON, it will also slash values inside both $_SERVER['QUERY_STRING'] and $_SERVER['SCRIPT_NAME'] (and equivalents) will also be slashed.`
Mark
14-Jun-2004 05:37
`You probably don't want to set "magic_quotes_runtime" because it affects even binary file read/write operations. This is especially problematic if you include someone else's library that depends on binary read/write. If you enable "magic_quotes_runtime", be sure to use set_magic_quotes_runtime() function call to disable it before calling someone else's library that does binary read/write.`
add a note
assert_options canWrite

Last updated: Fri, 26 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 11:33:19 2007 PST