Файл конфигурации php ini для новичков. Установка и настройка PHP

В htmlAcademy и я работаю на нем наставником. Студентам в рамках интенсива предстоит поднять рабочее окружение и это заметка нацелена упростить эту нелегкую для новичка задачу. Есть разные способы поднятия полноценного LAMP стека, но мы пойдем классическим путем. Настроим все компоненты по отдельности (без применения готовых комбайнов) и начнем с PHP (обязательно будет заметка с рассмотрением готовых сборок LAMP). Поскольку я планирую работать наставникам на интесивах по PHP и дальше, я собираюсь написать подобные инструкции для повторения в других ОС (Linux, macOS). Как говорится, лучше один раз попотеть, но потом всем станет проще. Итак, приступаем.

Загружаем PHP для Windows

Заходим на официальный сайт и загружаем актуальную версию PHP. На момент написания заметки это – 7.1.4
. На странице доступно несколько вариантов дистрибутивов. У меня Windows 7 x64, соответственно я выбираю zip архив с VC14 x64 Thread Safe.

Обратите внимание, для загрузки доступна два варианта дистрибутива: Thread-Safe (TS)
и Non-Thread-Safe (NTS)
. Выбор зависит от того как вы планируете применять интерпретатор. TS рекомендуется использовать для одного процесса веб-служб (например, настраивая через модуль mod_php для Apache). NTS рекомендуется для применения IIS (Internet Information Service) и альтернативных FastCGI веб-сервером (например, Apache с модулем FastCGI) и командной строки.

Устанавливаем PHP 7.1

Начнем готовить PHP для комфортной работе из командной строки. В предыдущем шаге вы загрузили архив с дистрибутивом PHP. В отличие от большинства программ, PHP поставляется в простом архиве, а не как инсталляционный пакет. Поэтому вам придется самостоятельно извлечь файлы в любую удобную для вас директорию. Я предпочитаю хранить подобные вещи в корне системного диска. Создайте в корне диска «C:» (или любом другом месте) директорию «php»
и извлеките в нее содержимое загруженного архива.

В директории появится множество файлов, но нас больше всего интересуют:

• go-pear.bat
  – сценарий для установки PEAR. Подробности о PEAR можно почитать в официальной документации .
• php.exe
  – позволяет выполнять PHP сценарии из консоли;
• php-win.exe
  – позволяет выполнять PHP сценарии без применения консоли;
• php-cgi.exe
  – необходим для выполнения PHP кода в режиме FastCGI;
• php7apache2_4.dll
  – модуль интеграции с веб-сервером Apache 2.4.X;
• phpdbg.exe
  – отладчик;
• php.ini-development
  – пример конфигурационного файла PHP для окружения разработчика (development)
• php.ini-production
  – пример конфигурационного файла PHP для рабочего окружения (production)

Подключаем конфигурационный файл

Распакованный дистрибутив у нас есть, подключим для него конфигурационный файл. Мы собираемся ставить эксперименты, поэтому в качестве образца возьмем php.ini-development
. Сделайте копию этого файла в директорию php (C:php
) с именем php.ini
. ВАЖНО!
Делайте именно копию, не простое переименование. За время разработки вам может потребоваться изменять конфигурационный файл и есть все шансы совершить ошибку, которую трудно будет обнаружить.

В таких случаях нет ничего лучше, чем вернуться к эталонным настройкам. В нашем случае будет достаточно повторить копирование файла php.ini-development
в php.ini
. Итак, по окончанию телодвижений в директории с php должен появиться файлик php.ini. В дальнейших заметках мы обязательно поговорим о его содержимом более детально.

Тестируем PHP из командной строки

На этом шаге, так называемая «установка» завершена. Откройте консоль (cmd.exe
, ярлык доступен в меню «Стандартные») и введите команду:

C:phpphp.exe –version

Результат будет примерно таким:

PHP 7.1.4 (cli) (built: Apr 11 2017 19:54:37) (ZTS MSVC14 (Visual C++ 2015) x64)
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.1.0, Copyright (c) 1998-2017 Zend Technologies

Результат подтверждает, что PHP работает. Попробуйте для примера создать новый файл-сценарий (я создал файл “test.php” прямо в корне диска “C:”) и поместить в него текст:

Теперь попробуйте выполнить этот файл и посмотрите результат:

C:phpphp.exe –f test.php

Функция phpinfo()
выводит информацию по конфигурации PHP в удобном виде. Об этой функции мы еще поговорим.

Упрощаем обращение к php.exe

PHP готов к работе, но согласитесь, каждый раз вбивать в консоле путь к php интерпретатору довольно неудобно. Чтобы упростить себе жизнь, внесем небольшие изменения в переменные среды. Запустим в панели управления аплет «Система»
(или просто нажмем горячую клавишу «Windows + Pause Break»
. Затем нажмем на кнопку «Изменить параметры»
. В появившемся окне «Свойства системы»
, перейдем на закладку «Дополнительно»
. Найдите и нажмите на ней кнопку «Переменные среды»
.

Находим в списке переменную «PATH»
и нажимаем кнопку «Изменить»
, появится окно редактирования переменной. В поле «Значение переменной» нам необходимо дописать путь к директории с PHP. Перейдите в самый конец строки и через точку с запятой укажите путь к директории с PHP: C:php;

Все, нажимайте «Ok». Теперь перезагрузите систему (увы, придется). После перезагрузки Windows, обращаться к PHP можно будет просто: php.Например, чтобы вывести название версии достаточно написать:

Php –version

А чтобы интерпретировать файл test.php, расположенный в корне диска «C:»:

Php –f C:test.php

Или вовсе запустить встроенный веб-сервер:

Php -t C: -S 127.0.0.1:8888
Listening on http://127.0.0.1:8888
Document root is C:
Press Ctrl-C to quit.

Для тестирования откройте web-браузер попробуйте обратиться на http://127.0.0.1:8888/test.php . Обратите внимание, после параметра –t
мы указываем путь к директории, которая станет корневой директорией веб-сервера. Все сценарии, расположенные в этой папке будут доступны для запроса с клиента. У меня на диске «C:» есть один файлик 1.php
и именно его я и запрашиваю.

Assoc .php=phpfile
ftype phpfile=”C:phpphp.ee” -f “%1” — %~2

Еще немного о переменных окружения

Теперь давайте поговорим о том как PHP будет искать файл настроек конфигурации (вспоминаем, о php.ini
). В документации приведена полная цепочка поиска. Во избежание лишних сложностей, рекомендую сразу добавить в переменные окружения новую – «PHPRC»
и в качестве значения указать путь к директории с конфигурационным файлом. У меня конфиг располагается в тоже же директории, что и основные файлы php, следовательно в качестве значения переменной указываю –

«C:php». После внесения изменения потребуется перезагрузка.

На этом у меня все. Первый часть мануала для новичков готова.

А сегодня мы поговорим об установке PHP
. Как и в случае с Apache здесь нет ничего сложного. Если вы первый раз занимаетестьустановкой и настройкой PHP
на локальной машине, то вам будет полезно прочитать это руководство с картинками. Если вы уже матерый зубр в этих делах, то можете смело пропустить эту заметку.

Итак, если вы читаете этот пост, то либо вы первый раз устанавливаете PHP, либо у вас возникли вопросы/проблемы в процессе установки или настройки PHP. Я постараюсь как можно подробнее описать этот процесс.

Для начала нам нужен дистрибутив с самой свежей версией PHP. Его можно скачать с официального сайта – www.php.net (9.5 Mb).

Скачиваем дистрибутив на компьютер, выбирая зеркало, которое географически наиболее ближе к вам находиться

Извлекаем содержимое архива в папку C:/php5
. Опять же, если вы первый раз устанавливаете связку Apache -PHP- MySQL рекомендую устанавливать по указанным мной путям.

Итак, в C:/php5
у вас должно находиться следующее:

Установка PHP завершена, теперь займемся его настройкой.

Переименуйте файл php.ini-recommended
в php.ini
:

• выбираем файл
• нажимаем F2
• удаляем -recommended
• нажимаем Enter.

Теперь откроем файл в блокноте и займемся настройкой PHP
. Файл содержит в себе довольно большое количество настроек PHP, но нам они сейчас не нужны. Мы займемся лишь базовой настройкой, которая позволит нам запустить PHP на локальной машине.

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

Символ ‘;’ означает, что строки закоментированы (они не будут учитываться). Например:

; ignore_user_abort = On

Как вы могли заметить настройки поделены на группы, для удобства поиска по файлу. Например, настройки управления ограничением ресурсов:

;;;;;;;;;;;;;;;;;;;;;;
; Resource Limits ;
;;;;;;;;;;;;;;;;;;;;;;

max_execution_time = 30 ; Maximum execution time of each script, in seconds (Максимальное время выполнения скрипта).
max_input_time = 60 ; Maximum amount of time each script may spend parsing request data
;max_input_nesting_level = 64 ; Maximum input variable nesting level
memory_limit = 128M ; Maximum amount of memory a script may consume (128MB) (Максимальное количество выделяемой для скрипта памяти).

Формат описания параметров и их значений:

имя_переменной = ее_значение

Настройка модулей PHP.

Найдите секцию Dynamic Extensions
(динамические расширения). Там представлен довольно большой список модулей для PHP:

;extension=php_bz2.dll
;extension=php_curl.dll
;extension=php_dba.dll
;extension=php_dbase.dll
;extension=php_exif.dll
;extension=php_fdf.dll
;extension=php_gd2.dll
;extension=php_gettext.dll
;extension=php_gmp.dll
;extension=php_ifx.dll
;extension=php_imap.dll
;extension=php_interbase.dll
;extension=php_ldap.dll
;extension=php_mbstring.dll
;extension=php_mcrypt.dll
;extension=php_mhash.dll

;extension=php_ming.dll
;extension=php_msql.dll
;extension=php_mssql.dll
;extension=php_mysql.dll
;extension=php_mysqli.dll
;extension=php_oci8.dll
;extension=php_openssl.dll
;extension=php_pdo.dll

;extension=php_pdo_mssql.dll
;extension=php_pdo_mysql.dll
;extension=php_pdo_oci.dll
;extension=php_pdo_oci8.dll
;extension=php_pdo_odbc.dll
;extension=php_pdo_pgsql.dll

;extension=php_pgsql.dll
;extension=php_pspell.dll
;extension=php_shmop.dll
;extension=php_snmp.dll
;extension=php_soap.dll
;extension=php_sockets.dll
;extension=php_sqlite.dll
;extension=php_sybase_ct.dll
;extension=php_tidy.dll
;extension=php_xmlrpc.dll
;extension=php_xsl.dll

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

Для того чтобы подключить модуль нужно удалить перед строкой символ ‘;’. Тем самым мы раскомментируем строку и модуль будет использоваться.

Давайте подключим расширение PHP для работы с графикой – php_gd2.dll
(оно нам понадобиться в будущем).

Для того, чтобы PHP смог найти, где лежат расширения, укажем путь к ним. Добавьте следующую строку до или после подключения расширений. В итоге у вас должно получиться следующее:

;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
;
; If you wish to have an extension loaded automatically, use the following
; syntax:
;
; extension=modulename.extension
;
; For example, on Windows:
;
; extension=msql.dll
;
; … or under UNIX:
;
; extension=msql.so
;
; Note that it should be the name of the module only; no directory information
; needs to go here. Specify the location of the extension with the
; extension_dir directive above.

; Windows Extensions
; Note that ODBC support is built in, so no dll is needed for it.
; Note that many DLL files are located in the extensions/ (PHP 4) ext/ (PHP 5)
; extension folders as well as the separate PECL DLL download (PHP 5).
; Be sure to appropriately set the extension_dir directive.

extension_dir=”C:/php5/ext”

;extension=php_bz2.dll
;extension=php_curl.dll
;extension=php_dba.dll
;extension=php_dbase.dll
;extension=php_exif.dll
;extension=php_fdf.dll
extension=php_gd2.dll
;extension=php_gettext.dll
;extension=php_gmp.dll
;extension=php_ifx.dll
;extension=php_imap.dll
;extension=php_interbase.dll
;extension=php_ldap.dll
;extension=php_mbstring.dll
;extension=php_mcrypt.dll
;extension=php_mhash.dll
;extension=php_mime_magic.dll
;extension=php_ming.dll
;extension=php_msql.dll
;extension=php_mssql.dll
;extension=php_mysql.dll
;extension=php_mysqli.dll
;extension=php_oci8.dll
;extension=php_openssl.dll
;extension=php_pdo.dll
;extension=php_pdo_firebird.dll
;extension=php_pdo_mssql.dll
;extension=php_pdo_mysql.dll
;extension=php_pdo_oci.dll
;extension=php_pdo_oci8.dll
;extension=php_pdo_odbc.dll
;extension=php_pdo_pgsql.dll
;extension=php_pdo_sqlite.dll
;extension=php_pgsql.dll
;extension=php_pspell.dll
;extension=php_shmop.dll
;extension=php_snmp.dll
;extension=php_soap.dll
;extension=php_sockets.dll
;extension=php_sqlite.dll
;extension=php_sybase_ct.dll
;extension=php_tidy.dll
;extension=php_xmlrpc.dll
;extension=php_xsl.dll
;extension=php_zip.dll

Сохраняем сделанные нами изменения. Чтобы сделанные нами настройки применились необходимо перезагрузить Apache .

Установка и настройка PHP
завершена!

Как видите – ничего сложного. Если в процессе работы вам понадобятся другие расширения, просто раскомментируйте строку, с нужным вам расширением (аналогично с php_gd2.dll
) и перезагрузите Apache .

В следующем посте, я расскажу как заставить работать PHP и Apache в связке.

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_MACHINESOFTWAREPHP]
  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:phplib”

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.

Настройка PHP
, как оказалось, не очень сложное занятие. Ознакомиться с настройками PHP 5.3
можно в файле «php.ini
«, находящемуся в директории WINDOWS (путь к конфигурационному файлу выглядит примерно так: «%WINDOWS%php.ini». К нему, безусловно, предполагается backup, находящийся в директории «PHPBACKUP». Файл настроек PHP можно по-разному редактировать, удалять из него комментарии и пояснения (кстати, такие же операции можно проводить и с файлом «httpd.conf». Синтаксис файла php.ini: «директива = значение». Выглядит это примерно вот так:

Директива = значение; пояснение
директива =
;директива = значение;директива =

и тому подобное.

В конфигурационном файле PHP есть специализированный знак комментария — «;». Все, что находится после этого знака, не воспринимается.

Общие настройки

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

Short_open_tag = On

Включив эту директиву, вы сможете заключать код в такие теги « ?>», вместо таких ««.

Для облегчения отладок сценария можно включить вывод ошибок непосредственно в ваш браузер:

Display_errors = On

Показывать все ошибки, кроме замечаний:

Error_reporting = E_ALL & ~E_NOTICE

Запись ошибок в файл журнала, которую, однако, лучше отключить для локального использования:

Log_errors = Off

Порядок, в котором PHP будет регистрировать перменные (E — встроенные переменные, G — GET переменные, P — POST переменные, C — Cookies, S — сессии). Отсутствие какой-либо из букв не позволит вам работать с соответствующими переменными, поэтому необходимо задать следующий порядок:

Variables_order = “EGPCS”

Возможность обращения к переменным, поступающим через GET/POST/Cookie/сессии, как к обычным переменным (например, «$переменная»), так как обращаться к этим переменным можно было только через суперглобальные массивы. Включать рекомендуется только в специфичных случаях (например, «$_POST[‘переменная’]):

Register_globals = On

Отключение автоматической обработки кавычек, поступающих через POST/GET/Cookie:

Magic_quotes_gpc = Off

Настройки загрузки файлов

Директива, разрешающая загрузку файлов:

File_uploads = On

Upload_tmp_dir = C:Tempuploadtemp

Максимальный размер файла, загружаемого вами:

Upload_max_filesize = 3M

Динамически загружаемые расширения

Путь к папке с расширениями :

Extension_dir = extensions

или абсолютный:

Extension_dir = C:ServerPHPextensions

Подключение динамических библиотек. Рекомендуется включать только нужные вам библиотеки. Для того, чтобы подключить ту или иную библиотеку, можно просто раскомментировать строчку. Например, для подключения графической библиотеки GD, раскомментируйте следующую строку:

Extension=php_gd2.dll

Настройка SMTP-сервера

Используемый SMTP-сервер:

SMTP = localhost

Smtp_port = 25

Адрес, который будет указываться в поле «From» в :

Sendmail_from = [email protected]

Настройка MySQL

Все мы работаем с разными версиями PHP, поэтому и настраивать их надо по-разному. В более поздних версиях PHP есть поддержка встроенной в ядро БД MySQL, а в более ранних — нету. Так что, если в архиве с расширениями, который вы скачали, нет библиотеки «php_mysql.dll», то ваша версия PHP поддерживает MySQL, если же эта библиотека присутствует, то вам нужно ее подключить:

Extension=php_mysql.dll

Указание порта:

Mysql.default_port = 3306

и хоста MySQL по умолчанию

Mysql.default_host = localhost

Настройка сессий

Хранить данные сессий в файлах:

Session.save_handler = files

Папка для хранения файлов сессий (не забудте создать этот каталог!):

Session.save_path = C:/Temp/session

Использовать cookie в сессиях:

Session.use_cookies = 1

Исользовать в качестве имени сессии и сессионной cookie ID сессии:

Session.name = PHPSESSID

Запрет на инициализацию сессии при начале соединения:

Session.auto_start = 0

Время жизни сессионных cookie («0» — до закрытия окна браузера):

Session.cookie_lifetime = 0

Session.use_trans_sid = 1

Настройка PHP
завершена. Вам необходимо перезапустить Apache для того, чтобы изменения вступили в силу.
Были использованы материалы с тематического сайта codenet.ru.

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

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

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

Если вам предстоит самостоятельная установка системы или перенос сайта на хостинг, то без курса
Установка и настройка

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

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

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