Файл конфигурации php ini для новичков. Установка и настройка PHP. Использование разных наборов настроек PHP

  • 03.11.2019

PHP - один из наиболее популярных языков программирования, применяющихся для создания Web-сайтов.

Скачайте с официального сайта PHP http://www.php.net дистрибутив (у меня - php 5.1.6 ). Распакуйте архив в каталог C:\Program Files\php . Найдите конфигурационный файл php.ini , содержащий настройки интерпретатора PHP , и внесите в него следующие изменения:

    Директива register_globals в php 5.1.6 по умолчанию включена (рекомендуется ):

    register_globals = on

    Установите максимальный объем данных, отправляемых методом POST , равным 16М :

    post_max_size = 16M

    Найдите строку:

    ;include_path = ".;c:\php\includes"

    раскомментируйте ее (для чего удалите символ точки с запятой ; в начале строки ) и исправьте на:

    include_path = ".;C:\Program Files\PHP\PEAR"

    Необходимо установить параметр extension_dir равным той директории, в которой находится дистрибутив PHP :

    Extension_dir = "C:/Program Files/php/ext"

    Установите максимальный размер закачиваемых файлов равным 16М :

    upload_max_filesize = 16M

    Параметру doc_root надо передать значение директивы DocumentRoot Web-сервера:

    doc_root = "d:/main/html"

    Если необходимо использование расширений PHP , уберите комментарий (символ точки с запятой ; ) у строк:

    ; extension = php*.dll
    .
    .
    .
    ; extension = php*.dll

    Следующих расширений достаточно для полноценной работы PHP :

    Php_mbstring.dll – библиотека предназначена для работы с много-байтными кодировками, к которым относятся кодировки восточных языков (японский, китайский, корейский ), Юникод (UTF-8 ) и др.

    php_bz2.dll – расширение служит для создания и распаковывания архивов в формате bzip2 .

    Php_curl.dll – позволяет соединяться и работать с серверами с помощью различных интернет-протоколов.

    Php_gd2.dll – расширение позволяет работать с графикой.

    Php_mysql.dll – библиотека необходима для работы с сервером MySQL .

    Php_mysqli.dll – библиотека является расширением php_mysql.dll . Она содержит дополнительные функции PHP для работы с сервером MySQL версии 4.1.3 и выше.

    Параметр

    error_reporting = E_ALL & ~E_NOTICE

    позволяет выводить все ошибки, за исключением замечаний. Это значение установлено по умолчанию, его и оставляем.

    Но PHP 5 (в отличие от предыдущих версий ) не выводит ряд ошибок в окно браузера (в связи с требованиями безопасности ).

    Просмотреть всю информацию об ошибках можно в log-файлах. Для ее размещения в них необходимо, чтобы параметр log_errors имел значение On :

    log_errors = On

    Для отладки Web-приложений с выводом сообщений об ошибках в окно браузера, следует установить параметр display_errors:

    display_errors = On

    Присвоение параметрам display_errors и log_errors значения off позволяет запретить вывод сообщений об ошибках в окно браузера и log-файл соответственно.

    Директива

    e r r o r _l o g = syslog

    позволяет регистрировать ошибки в системном журнале Windows.


    Найдите строку:

    session.save_path = "F:/main/tmp"

    и укажите путь к папке для хранения временных файлов. У меня это папка Temp на диске C :

    session.save_path = "C:/Temp"

    Для хранения временных файлов сессий можно создать отдельную папку Temp в каталоге php . Тогда:

    session.save_path = "C:/Program Files/php/Temp"

    В конфигурационном файле Web-сервера Apache httpd.conf перед блоком описания виртуальных хостов необходимо добавить следующие строки:

    AddType application/x-httpd-php phtml php

    Options ExecCGI

    Action application/x-httpd-php "/php_dir/php-cgi.exe"

Теперь необходимо перезапустить сервер Apache и проверить работу PHP .

Для этого в директории d:/main/html следует создать файл test.php . Для создания PHP-файла можно воспользоваться текстовым редактором Блокнот , в котором следует написать любой небольшой скрипт, например:

e c h o (" H e l l o , РНР!");
?>

Если при наборе в адресной строке браузера запроса http://localhost/test.php появится строка

Hello, PHP!

То установка прошла успешно!

php имеет множество настроек, описанных в файле php.ini. Этот файл должен быть доступен в системных путях поиска для того, чтобы php мог использовать эти настройки. Обычно для этого достаточно хранить этот файл в том же каталоге, где расположен сам php, но если php сконфигурирован для работы в качестве модуля web-сервера, то этот файл необходимо скопировать в каталог, явно доступный в системных путях поиска. См. раздел инсталляции php для получения более подробных инструкций.

Здесь рассматриваются основные параметры php, разделенные по категориям. Список параметров в основном соответствует версии php 4.0.6, однако здесь рассматриваются только основные параметры. Полный список параметров с комментариями по каждому из них можно увидеть непосредственно в php.ini, а также в соответствующем разделе php manual.

Значения параметров, имеющих варианты "да/нет" могут быть следующими:

ДА - 1, on, true or yes
НЕТ - 0, off, false or no

Short_open_tag

Включение поддержки сокращенного варианта php тегов. Если эта опция отключена, то php код будет распознаваться только внутри тегов. Если включена - то разрешено использование тегов. Хорошим тоном считается не использовать сокращенной записи php тегов.

Включение поддержки asp тегов <% %> в качестве php тегов.

Output_buffering

Включение буферизированного вывода php. Использование буферизированного вывода позволит вам, к примеру, использовать любые функции, оперирующие с http header"ами (header(), setcookie()) в любом месте вашего скрипта, не заботясь о том, чтобы не выводить ничего до этого. Вы можете управлять буферизированным выводом и из ваших скриптов (см. раздел output control functions в php manual). Помните, что при включенной буферизации вывода результат работы скрипта будет возвращен браузеру только после того, как будет закончена работа скрипта, что может привести к более медленной работе сайта.

Включение безопасного режима работы php. Безопасный режим запрещает скриптам производить любые действия, которые являются небезопасными для сервера, на котором работает php. Очень подробно безопасный режим работы php рассматривается в php manual.

Max_execution_time

Максимальное время работы php скрипта (в секундах). Спустя это время работа скрипта будет принудительно завершена и выдана соответствующая ошибка. Позволяет избежать проблем с "зациклившимися" скриптами.

Максимальный объем памяти, который может быть выделен для нужд скрипта. Также позволяет избежать проблем с "зациклившимися" скриптами.

Error_reporting

Маска для сообщений об ошибках, которые должны генерироваться php. Задается в виде логического выражения с использованием набора предопределенных констант, описывающих различные типы ошибок. Список этих констант, а также правила задания выражений можно найти в php.ini.

Display_errors

Определяет, нужно ли выводить сообщения об ошибках на экран. Обычно эта опция включается во время написания php скриптов, для того, чтобы иметь возможность видеть сообщения об ошибках, а на реальных серверах в интернете она обычно выключена по соображениям безопасности.

Если включена эта опция, то все ошибки будут записываться в log файл, определенный следующей опцией.

Путь и имя файла, куда будут записываться все сообщения об ошибках, генерируемых php. Для систем поддерживающих системный журнал ошибок можно установить значение этого параметра равным syslog, для того, чтобы перенаправить все сообщения об ошибках туда.

Если включена эта опция, то текст последней ошибки будет всегда доступен из переменной $php_errormsg.

Register_globals

Этот параметр определяет, будут ли т.н. egpcs переменные (environment, get, post, cookies, session) доступны в виде глобальных переменных php. Если этот параметр разрешен, то переменные доступ к этим переменным будет осуществляться также, как и к любым другим глобальным переменным php:


echo "Версия http протокола: " . $server_protocol ;
echo "Параметр query string: " . $param1 ;
echo "Элемент формы: " . $txtfirstname ;
echo "Мои cookie: " . $mycookie ;
echo . $mysessionvar ;

Или то же самое, но с отключенным параметром:


echo "Версия http протокола: " . $http_env_vars [ "server_protocol" ];
echo "Параметр query string: " . $http_get_vars [ "param1" ];
echo "Элемент формы: " . $http_post_vars [ "txtfirstname" ];
echo "Мои cookie: " . $http_cookie_vars [ "mycookie" ];
echo "Мои сессионные переменные: " . $http_session_vars [ "mysessionvar" ];

На первый взгляд это менее удобно, но отключение этого параметра имеет и свои преимущества:

Php начинает работать немного быстрее, т.к. не тратится дополнительное время на создание множества переменных.
Нет риска того, что какие-то две переменные будут иметь одинаковые имена, что приведет к появлению ошибок в работе скрипта, которые будет очень сложно отловить в силу их неочевидности.
variables_order

Этот параметр используется в связке с предыдущим параметром и определяет, в какой последовательности производится регистрация глобальных egpcs переменных. Например, при значении по умолчанию (egpcs) переменные, переданные через get будут замещены переменными, переданными через post и имеющими то же имя. post-переменные (а также environment и get переменные) в свою очередь могут быть замещены значениями cookies с такими же именами и т.д.

Magic_quotes_gpc

Включение этого параметра приведет к тому, что все данные, поступающие со стороны клиента (через get, post или cookie) будут обработаны: все кавычки (" и ") в них будут замещены соответственно сочетанием " или ". С одной стороны это очень удобно, если планируется, например, вставлять эти данные в строки, передаваемые, например, sql серверу. Но с другой стороны это может привести к путанице, поэтому обычно надежнее использовать для этой цели функции addslashes() и stripslashes().

Magic_quotes_runtime

Данный параметр аналогичен предыдущему за исключением того, что влияет на данные, поступающие из внешних источников, расположенных на стороне сервера (например, данные, поступающие от sql сервера или результаты работы внешних программ).

Magic_quotes_sybase

Включение этой опции приведет к тому, что одинарные кавычки (") будут сдваиваться (""). Это необходимо для некоторых sql серверов, которые поддерживают только такой способ вставки кавычек в строки (interbase, ms sql, sybase и некоторые другие).

Auto_prepend_file

Позволяет задать путь и имя файла, который будет автоматически добавляться в начало каждого php скрипта. Используется только если имеет непустое значение.

Auto_append_file

То же самое, что предыдущий параметр, но добавление содержимого файла производится в конец каждого php скрипта.

Путь к каталогу, где лежат модули php. Обычно это подкаталог extensions в корневом каталоге php.

The configuration file (php.ini) is read when PHP starts up. For the server module versions of PHP, this happens only once when the web server is started. For the CGI and CLI versions, it happens on every invocation.

php.ini is searched for in these locations (in order):

  • SAPI module specific location (PHPIniDir directive in Apache 2, -c command line option in CGI and CLI, php_ini parameter in NSAPI, PHP_INI_PATH environment variable in THTTPD)
  • The PHPRC environment variable. Before PHP 5.2.0, this was checked after the registry key mentioned below.
  • As of PHP 5.2.0, the location of the php.ini file can be set for different versions of PHP. The root of the registry keys depends on 32- or 64-bitness of the installed OS and PHP. For 32-bit PHP on a 32-bit OS or a 64-bit PHP on a 64-bit OS use [(HKEY_LOCAL_MACHINE\SOFTWARE\PHP] for 32-bit version of PHP on a 64-bit OS use ] instead. For same bitness installation the following registry keys are examined in order: , and , where x, y and z mean the PHP major, minor and release versions. For 32 bit versions of PHP on a 64 bit OS the following registry keys are examined in order: , and , where x, y and z mean the PHP major, minor and release versions. If there is a value for IniFilePath in any of these keys, the first one found will be used as the location of the php.ini (Windows only).
  • or , value of IniFilePath (Windows only).
  • Current working directory (except CLI).
  • The web server"s directory (for SAPI modules), or directory of PHP (otherwise in Windows).
  • Windows directory (C:\windows or C:\winnt) (for Windows), or --with-config-file-path compile time option.

If php-SAPI.ini exists (where SAPI is the SAPI in use, so, for example, php-cli.ini or php-apache.ini), it is used instead of php.ini . The SAPI name can be determined with php_sapi_name() .

The Apache web server changes the directory to root at startup, causing PHP to attempt to read php.ini from the root filesystem if it exists.

Using environment variables can be used in php.ini as shown below.

Example #1 php.ini Environment Variables

; PHP_MEMORY_LIMIT is taken from environment memory_limit = ${PHP_MEMORY_LIMIT}

The php.ini directives handled by extensions are documented on the respective pages of the extensions themselves. A list of the core directives is available in the appendix. Not all PHP directives are necessarily documented in this manual: for a complete list of directives available in your PHP version, please read your well commented php.ini file. Alternatively, you may find from Git helpful too.

Example #2 php.ini example

; any text on a line after an unquoted semicolon (;) is ignored ; section markers (text within square brackets) are also ignored ; Boolean values can be set to either: ; true, on, yes ; or false, off, no, none register_globals = off track_errors = yes ; you can enclose strings in double-quotes include_path = ".:/usr/local/lib/php" ; backslashes are treated the same as any other character include_path = ".;c:\php\lib"

Since PHP 5.1.0, it is possible to refer to existing .ini variables from within .ini files. Example: open_basedir = ${open_basedir} ":/new/dir" .

Scan directories

It is possible to configure PHP to scan for .ini files in a directory after reading php.ini . This can be done at compile time by setting the --with-config-file-scan-dir option. In PHP 5.2.0 and later, the scan directory can then be overridden at run time by setting the PHP_INI_SCAN_DIR environment variable.

It is possible to scan multiple directories by separating them with the platform-specific path separator (; on Windows, NetWare and RISC OS; : on all other platforms; the value PHP is using is available as the PATH_SEPARATOR constant). If a blank directory is given in PHP_INI_SCAN_DIR , PHP will also scan the directory given at compile time via --with-config-file-scan-dir .

Within each directory, PHP will scan all files ending in .ini in alphabetical order. A list of the files that were loaded, and in what order, is available by calling php_ini_scanned_files() , or by running PHP with the --ini option.

Assuming PHP is configured with --with-config-file-scan-dir=/etc/php.d, and that the path separator is:... $ php PHP will load all files in /etc/php.d/*.ini as configuration files. $ PHP_INI_SCAN_DIR=/usr/local/etc/php.d php PHP will load all files in /usr/local/etc/php.d/*.ini as configuration files. $ PHP_INI_SCAN_DIR=:/usr/local/etc/php.d php PHP will load all files in /etc/php.d/*.ini, then /usr/local/etc/php.d/*.ini as configuration files. $ PHP_INI_SCAN_DIR=/usr/local/etc/php.d: php PHP will load all files in /usr/local/etc/php.d/*.ini, then /etc/php.d/*.ini as configuration files.

Changelog

Version Description
7.0.0 Hash marks (# ) are no longer recognized as comments.
5.3.0 Hash marks (# ) should no longer be used as comments and will throw a deprecation warning if used.
5.2.0 The PHP_INI_SCAN_DIR environment variable can be set to override the scan directory set via the configure script.
5.1.0 It is possible to refer to existing .ini variables from within .ini files.

Последнее обновление: 16.12.2017

Есть разные способы установки всего необходимого программного обеспечения. Мы можем устанавливать компоненты по отдельности, а можем использовать уже готовые сборки на подобие Denwer или EasyPHP. В подобных сборках компоненты уже имеют начальную настройку и уже готовы для создания сайтов. Однако рано или поздно разработчикам все равно приходится прибегать к установке и конфигурации отдельных компонентов, подключения других модулей. Поэтому мы будем устанавливать все компоненты по отдельности. В качестве операционной системы будет использоваться Windows.

Что подразумевает установка PHP? Во-первых, нам нужен интерпретатор PHP. Во-вторых, необходим веб-сервер, например, Apache, с помощью которого мы сможем обращаться к ресурсам создаваемого нами сайта. В-третьих, поскольку мы будем использовать базы данных, то нам также надо будет установить какую-нибудь систему управления базами данных. В качестве такой выбрана MySQL как наиболее популярная в связке с PHP.

Для установки PHP перейдем на офсайт разработчиков http://php.net/ . На странице загрузок мы можем найти различные дистрибутивы для операционной системы Linux. Если нашей операционной системой является Windows, то нам надо загрузить один из пакетов со страницы http://windows.php.net/download/ .

Загрузим zip-пакет последнего выпуска PHP:

Как правило, последний выпуск PHP имеет две версии: Non Thread Safe и Thread Safe. Нам надо выбрать версию Thread Safe . Для этой версии доступны варинты для 32-битной и 64-битной систем.

Распакуем загруженный архив в папку, которую назовем php . Пусть эта папка у нас будет располагаться в корне диска C.

Теперь нам надо выполнить минимальную конфигурацию PHP. Для этого зайдем в каталог c:\php и найдем там файл php.ini-development . Это файл начальной конфигурации интерпретатора. Переименуем этот файл в php.ini и затем откроем его в текстовом редакторе.

Найдем в файле строку:

; extension_dir = "ext"

Эта строка указывает на каталог с подключаемыми расширениями для PHP. Раскомментируем ее (убрав точку с запятой):

Extension_dir = "ext"

Так как все расширения находятся в каталоге ext .

Поскольку мы будем использовать базы данных MySQL, то нам надо указать расширение в php.ini. По умолчанию оно уже имеется в файле, только оно закомментировано:

;extension=mysqli

Раскомментируем его, убрав знак точки с запятой:

Extension=mysqli

Теперь по умолчанию эта библиотека будет использоваться при работе с базой данных. Также мы можем при необходимости раскомментировать и другие расширения. Но для начала нам хватит и одного.

Остальное содержимое файла оставим без изменений.

Теперь установим веб-сервер.

Курс предназначен для базовой подготовки администраторов сайтов, созданных на "1С-Битрикс: Управление сайтом" . Изучив курс, вы освоите основные методы администрирования системы, а также пополните знания по темам, изученным в курсе Контент-менеджер .

Если вы добросовестно изучите курс, то научитесь:

  • управлять доступом к системе, сайтами, пользователями, группами пользователей;
  • работать с инструментами системы;
  • использовать возможности интерфейса по управлению системой;
  • работать с модулями "1С-Битрикс: Управление сайтом", связанными с оптимизацией и безопасностью работы сайта;
  • выполнять работу по конфигурированию веб-системы для оптимальной работы.

Если вам предстоит самостоятельная установка системы или перенос сайта на хостинг, то без курса Установка и настройка Курс Установка и настройка предназначен для специалистов устанавливающих "1С-Битрикс: Управление сайтом" или "Битрикс24 в коробке".

Скачать материалы курса в формате CHM .

Как проходить учебный курс?