// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= Настройка среды разработки PHP в Windows
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: Настройка среды разработки PHP в Windows - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, Настройка среды разработки PHP в Windows

В данном учебном курсе рассматриваются два способа настройки среды разработки PHP в операционной системе Windows. Первый и наиболее удобный способ состоит в установке и настройке пакета AMP (*A*pache, *М*ySQL, *P*HP). В данном учебном курсе приводится процедура установки пакета XAMPP. Второй способ состоит в установке и настройке каждого компонента по отдельности.


*Для работы с этим учебным курсом требуется следующее программное обеспечение и ресурсы.*

|===
|Программное обеспечение или материал |Требуемая версия 

|link:https://netbeans.org/downloads/index.html[+IDE NetBeans+] |Пакет загрузки PHP 

|Механизм PHP |Версия 5. Содержится в link:http://www.apachefriends.org/en/xampp-windows.html[+XAMPP Windows+]. 

|Веб-сервер |Рекомендуется использовать link:http://httpd.apache.org/download.cgi[+сервер HTTP Apache версии 2.2+].
Содержится в XAMPP для Windows. 

|Сервер базы данных |Рекомендуется использовать link:http://dev.mysql.com/downloads/mysql/5.1.html[+сервер MySQL 5.0+].
Содержится в XAMPP для Windows. 

|Отладчик PHP (не обязательно) |link:http://www.xdebug.org[+Версия XDebug 2.0 или выше.+]
 
|===

Как правило, разработка и отладка выполняются на локальном веб-сервере, в то время как производственная среда размещена на удаленном веб-сервере. Настройка удаленного веб-сервера описана в разделе link:./remote-hosting-and-ftp-account.html[+ Развертывание приложения PHP на удаленном веб-сервере с помощью IDE NetBeans+]. Этот учебный курс содержит информацию, необходимую для настройки локального веб-сервера. Поддержка PHP может добавляться к целому ряду локальных веб-серверов (IIS, Xitami и т.д.), но обычно используется link:http://httpd.apache.org/download.cgi[+сервер HTTP Apache+]. Сервер HTTP Apache включен в пакет AMP XAMPP, используемый в этом учебном курсе. Сведения относительно установки и настройки автономного сервера HTTP Apache приведены link:http://httpd.apache.org/docs/2.2/install.html[+здесь+].


== Требуемое программное обеспечение

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

* IDE NetBeans для PHP. Загрузку можно осуществить link:https://netbeans.org/downloads/index.html[+отсюда+].
* Веб-сервер. Как правило, разработка и отладка выполняются на локальном веб-сервере, в то время как производственная среда размещена на удаленном веб-сервере. Текущая версия позволяет использовать локальный сервер. Последующие версии будут поддерживать использование удаленного сервера с доступом по протоколу FTP. Поддержка PHP может добавляться к целому ряду веб-серверов (IIS, Xitami и т.д.), но обычно используется link:http://httpd.apache.org/download.cgi[+сервер HTTP Apache+]. Сведения относительно установки и настройки Apache 2.2 приведены link:http://httpd.apache.org/docs/2.2/install.html[+здесь+]. 

* Механизм PHP. Поддерживается версия PHP5. Загрузку можно осуществить link:http://www.php.net/downloads.php[+отсюда+].
* Отладчик PHP. IDE NetBeans для PHP позволяет использовать link:http://www.xdebug.org[+XDebug+], но использование отладчика не является обзательным. Из соображений совместимости с PHP5 рекомендуется использовать версию XDebug 2.0 или выше.
* Сервер базы данных. Существует возможность использования различных серверов базы данных, однако самым популярным из них является сервер MySQL. Загрузку можно осуществить link:http://dev.mysql.com/downloads/mysql/5.1.html[+отсюда+]. 
NOTE:  Рекомендуемая версия продукта: MySQL Server 5.0. В предоставленных документах описывается работа с этой версией.

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

Можно использовать <<XAMPP,пакет>>, содержащий требуемое программное обеспечение, или <<installComponentsSeparately,установить каждый компонент по отдельности>>.


== Использование пакета AMP

В целях автоматической установки всех параметров настройки для механизма PHP, сервера HTTP Apache и сервера базы данных MySQL воспользуйтесь пакетом AMP. В данном учебном курсе приведены указания только для пакета link:http://www.apachefriends.org/en/xampp-windows.html[+XAMPP-Windows+]. Справочные сведения по пакету WAMP или другим пакетам приведены в разделе link:http://wiki.netbeans.org/HowToConfigureXDebug[+NetBeans XDebug Wiki+].


=== Установка и настройка пакета XAMPP

В этом разделе приведено описание процедур загрузки, установки и настройки пакета XAMPP.

*Предупреждение!* НЕ используйте XAMPP 1.7.0. В этой версии имеются значительные проблемы с XDebug. Используйте версию 1.7.1 или выше, где эти неполадки устранены.

NOTE:  Начиная с XAMPP 1.7.2, XAMPP поставляется с PHP 5.3а не с PHP 5.2.x. IDE NetBeans для PHP версии 6.7.x не поддерживает новые функции PHP 5.3. IDE NetBeans для PHP 6.8, которая в настоящее время доступна как сборка разработки, полностью поддерживает PHP 5.3. Также обратите внимание, что установка Xdebug различается для PHP 5.2.x и PHP 5.3.

1. Загрузите пакет программы установки link:http://www.apachefriends.org/en/xampp-windows.html[+XAMPP +]. В состав XAMPP Lite не входит XDebug.
2. По завершении загрузки запустите файл  ``EXE`` .

В Microsoft Vista функция контроля учетных записей пользователей (UAC) блокирует обновление установщиком PHP настройки службы httpd Apache. На время установки XAMPP следует отключить UAC. Для получения дополнительных сведений обратитесь к разделу link:http://support.microsoft.com/kb/922708[+Поддержка Майкрософт+].


[start=3]
. Можно установить сервер Apache и сервер базы данных MySQL как веб-службы. Если Apache Server и MySQL установлены как службы, то нет необходимости запускать их вручную с помощью "XAMP Control Panel". Следует учитывать, что установить и удалить эти службы можно с помощью <<xamppConstolPanel,панели управления XAMPP>>.

[start=4]
. При использовании самораспаковывающегося архива после его распаковки запустите файл  ``setup-xampp.bat``  для настройки компонентов пакета. Программа установки XAMPP запускает этот файл автоматически.

[start=5]
. После настройки откройте панель управления XAMP. Эту панель можно открыть посредством запуска файла  ``XAMPP_HOME/xampp-control.exe``  или с помощью значка панель управления XAMPP, автоматически размещаемого на рабочем столе. При открытии панели управления XAMPP следует учитывать, что модули, установленные как службы, уже выполняются.

*Предупреждение. *Иногда в Windows Vista не удается запустить файл  ``xampp-control.exe`` . В этом случае можно запустить  ``xampp-start.exe`` .

*Предупреждение. *Файл  ``winmysqladmin.exe`` , запускаемый кнопкой "Admin" для MySQL, не функционирует. Отображается последовательность сообщений об ошибках, которая может быть остановлена только путем завершения процесса  ``winmysqladmin``  вручную. Файл  ``winmysqladmin.exe``  также невозможно запустить из командной строки. Обратитесь к странице link:http://bugs.xampp.org/view.php?id=71[+http://bugs.xampp.org/view.php?id=71+].

image::images/xampp-control-panel.png[]


[start=6]
. Флажки "Svc" указывают на то, что модуль устанавливается как служба Windows и автоматически выполняется при запуске системы. Службы Windows устанавливаются и удаляются при установке и снятии флажка "Svc". При удалении службы Windows сам модуль не удаляется, однако необходимо запускать его вручную. Панель управления XAMPP включает в себя кнопки запуска и остановки модулей, а также открытия их консолей администратора.


=== Проверка установки XAMPP

1. Запустите браузер и введите следующий URL-адрес:  ``http://localhost`` . Откроется страница приветствия XAMPP:

image::images/xampp-welcome-page.png[]


[start=2]
. В целях обеспечения установки серверов Apache и MySQL в качестве служб системы перезапустите операционную систему, запустите браузер и повторно введите URL-адрес  ``http://localhost`` . Откроется страница приветствия XAMPP. Обратите внимание на то, что в левом поле страницы приветствия XAMPP имеется меню, посредством которого можно проверить состояние компонентов XAMPP, запустить  ``phpinfo()`` , а также воспользоваться другими важными функциями. При выполнении  ``phpinfo()``  возвращается экран с информацией о настройке компонентов XAMPP. 

image::images/xampp-phpinfo.png[]


=== Установка и включение отладчика XDebug

Для использования отладчика XDebug необходимо настроить стек PHP. Процесс отличается, если используется <<xdebug-xampp-171,XAMPP 1.7.1>>, который включает в себя PHP 5.2.6, или <<xdebug-xampp-172,XAMPP 1.7.2>>, который включает в себя PHP 5.3.

Многие пользователи испытывают трудности при настройке работы XDebug в своих системах. Справочные сведения приведены на link:http://wiki.netbeans.org/HowToConfigureXDebug[+вики-странице+]и link:http://forums.netbeans.org/viewforum.php?f=13&sid=5b63e6774fe7859b5edd35b1192d8efd[+на форуме пользователей редактора NetBeans PHP Editor+].


[[xdebug-xampp-171]]
==== XDebug на XAMPP 1.7.1 (PHP 5.2)

Необходимо скачать XDebug, поместить файл .dll в базовый каталог php и настроить php.ini для поиска и использования данного файла.

1. Загрузите самую последнюю, _ориентированную на многопотоковое исполнение_ версию link:http://www.xdebug.org/download.php[+XDebug+], совместимую с вашей версией PHP. Ссылки для загрузки перечислены в разделе "Releases". Скопируйте файл  ``.dll``  в каталог  ``XAMP_HOME/php/ext`` . ( ``XAMPP_HOME``  ссылается на каталог установки XAMPP или XAMPP Lite, например,  ``C:\Program Files\xampp``  или  ``C:\xampplite`` .)
2. Найдите и откройте активный файл  ``php.ini``  для XAMPP. По умолчанию он находится в каталоге  `` XAMPP_HOME/apache/bin`` . Подтвердите, какой файл  ``php.ini``  является активным, с помощью  ``phpinfo()``  и поиска загруженного файла конфигурации.
3. Поскольку оптимизатор Zend блокирует XDebug, оптимизатор требуется отключить. В активном файле  ``php.ini ``  найдите следующие строки и удалите или отметьте их как комментарии (для надежности выполните поиск и закомментируйте все свойства, связанные с Zend):

[source,ini]
----

[Zend]
;zend_extension_ts = "C:\Program Files\xampp\php\zendOptimizer\lib\ZendExtensionManager.dll"
;zend_extension_manager.optimizer_ts = "C:\Program Files\xampplite\php\zendOptimizer\lib\Optimizer"
;zend_optimizer.enable_loader = 0
;zend_optimizer.optimization_level=15
;zend_optimizer.license_path =

----

[start=4]
. Для присоединения
 XDebug к механизму PHP раскомментируйте следующие строки в файлах  ``php.ini``  (добавьте эти строки непосредственно в разделе [Zend]), если они отсутствуют. Добавлены дополнительные примечания.

[source,ini]
----

[XDebug]; Only Zend OR (!) XDebug
zend_extension_ts = "./php/ext/php_xdebug<-version-number>.dll"
; XAMPP and XAMPP Lite 1.7.0 and later come with a bundled xdebug at <XAMPP_HOME>/php/ext/php_xdebug.dll, without a version number.xdebug.remote_enable=1xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
; Port number must match debugger port number in NetBeans IDE Tools > Options > PHPxdebug.remote_handler=dbgpxdebug.profiler_enable=1xdebug.profiler_output_dir="<XAMPP_HOME>\tmp"
----

Установите свойство  ``xdebug.remote_enable``  в значение 1, а не в значение "true" или другое значение.

NOTE:  Убедитесь в том, что указанные пути соответствуют расположению соответствующих файлов, как это определено при установке.


[start=5]
. Сохраните файл  ``php.ini`` .

[start=6]
. Запустите <<xamppConstolPanel,панель управления XAMPP>> и перезапустите сервер Apache.
Дополнительные сведения о настройке XDebug приведены на link:http://wiki.netbeans.org/HowToConfigureXDebug[+вики-странице+] и в link:http://www.xdebug.org/docs/install[+документации по XDebug+].


[[xdebug-xampp-172]]
==== Xdebug на XAMPP 1.7.2 (PHP 5.3)

XAMPP 1.7.2 поставляется вместе с соответствующим файлом Xdebug .dll. Для начала использования необходимо только настроить  ``php.ini`` . Обратите внимание, что все настройки Xdebug сопровождаются поясняющим текстом.

1. Найдите и откройте файл  ``XAMPP_HOME\php\php.ini``  для редактирования. В XAMPP 1.7.2 используется только файл  ``php.ini`` 
2. Найдите строку  ``zend_extension = "XAMPP_HOME\php\ext\php_xdebug.dll"``  и удалите символ комментария.
3. Найдите строку  ``xdebug.remote_host=localhost``  и удалите символ комментария. Измените значение параметра  ``localhost``  на  ``127.0.0.1`` .
4. Найдите строку  ``xdebug.remote_enable = 0``  и удалите символ комментария. Измените 0 на 1.
5. Найдите строку  ``xdebug.remote_handler = "dbgp"``  и удалите символ комментария.
6. Найдите строку  ``xdebug.remote_port = 9000``  и удалите символ комментария.
7. Сохраните файл  ``php.ini`` .
8. Запустите <<xamppConstolPanel,панель управления XAMPP>> и перезапустите сервер Apache.

Дополнительные сведения о настройке XDebug приведены на link:http://wiki.netbeans.org/HowToConfigureXDebug[+вики-странице+] и в link:http://www.xdebug.org/docs/install[+документации по XDebug+].


== Установка компонентов по отдельности


=== Сервер HTTP Apache


[start=1]
. Загрузите link:http://httpd.apache.org/download.cgi[+сервер HTTP Apache2+].

[start=2]
. Запустите установочный файл  ``.msi`` . Запускается мастер установки. Следуйте указаниям.

В Microsoft Vista не следует устанавливать Apache Server в местоположение по умолчанию, находящееся в папке "Program Files". Все файлы в папке "Program Files" защищены от записи.


[start=3]
. По завершении установки перезапустите сервер Apache.

[start=4]
. Для проверки успешности установки запустите браузер и введите следующий URL-адрес:

[source,ini]
----

  http://localhost/
----
Откроется страница приветствия Apache: 

image::images/install-apache-it-works-port80.png[]


==== Устранение проблем

По умолчанию сервер Apache прослушивает порт 80. Однако этот порт, возможно, уже используется другими службами, например Skype. Для разрешения проблемы измените порт, прослушиваемый сервером:

1. Откройте файл настройки веб-сервера Apache  ``httpd.conf`` . По умолчанию файл расположен в  ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` .
2. Перейдите к строке  ``Listen 80``  и замените номер порта: например, на  ``8080`` . Сохраните файл.
3. Перезапустите веб-сервер Apache.
4. Для проверки работоспособности веб-сервера запустите браузер, введите URL-адрес и явно укажите номер порта:  ``http://localhost:8080`` 

Кроме того, можно также приостановить процессы, прослушивающие порт 80. В окне "Диспетчер задач" выберите соответствующее имя файла и нажмите кнопку "Завершить процесс".

Дополнительные сведения об установке и настройке сервера приведены link:http://httpd.apache.org/docs/2.2/install.html[+здесь+].


=== Механизм PHP

1. Загрузите link:http://windows.php.net/download/[+бинарный пакет установщика Windows+] для выбранной версии PHP5.

*Важно.*Если установщик для нужной версии PHP отсутствует, установите ее вручную из файла .zip. См. раздел link:http://php.net/manual/en/install.windows.manual.php[+Этапы ручной установки+] в документации php.net.


[start=2]
. По завершении загрузки запустите установочный файл  ``.msi`` . Запускается мастер установки.

[start=3]
. На экране "Каталог конфигурации Apache" укажите каталог, в котором расположен файл  ``httpd.conf``  (по умолчанию используется каталог  ``C:\Program Files\Apache Software Foundation\Apache<version>\conf\`` ). Обработка кода PHP включается автоматически.

[start=4]
. При необходимости использования сервера базы данных MySQL выберите вариант "Полная установка" или выберите элементы MySQL и MySQLi в списке "Расширения".

[start=5]
. После завершения установки перезапустите сервер Apache.

[start=6]
. Для проверки успешности установки механизма PHP и включения обработки кода PHP в настройке Apache выполните следующие действия:
* Откройте блокнот или любой другой текстовый редактор. Создайте файл и введите следующий текст:

[source,php]
----

<?php 
     echo "PHP has been installed successfully!";
?>
----
* Сохраните файл в папке htdocs с именем `test.php`. По умолчанию путь к файлу имеет вид  ``C:\Program Files\Apache Software Foundation\Apache<version>\htdocs\test.php`` 
* Запустите браузер и введите следующий URL-адрес:  ``http://localhost:<port>/test.php`` . Откроется следующая страница:

image::images/install-php-test.png[]


==== Устранение проблем

Если страница не открывается, выполните следующие действия:

1. Перезапустите сервер Apache.
2. Убедитесь, что файл настройки сервера Apache httpd.conf содержит следующие строки:

[source,ini]
----

  AddType Application/x-httpd-php .php 
  LoadModule php5_module "c:/php/sapi/php5apache2_2.dll"
----

[start=3]
. Если эти строки отсутствуют, добавьте их, сохраните  ``httpd.conf``  и перезапустите сервер Apache.

[start=4]
. Обновите страницу http://localhost:<port>/test.php.


=== Сервер базы данных MySQL

Ознакомьтесь с подробными сведениями относительно link:../ide/install-and-configure-mysql-server.html[+установки и настройки сервера базы данных MySQL+].


=== XDebug

1. Загрузите link:http://www.xdebug.org[+XDebug+].
2. Установите XDebug в папку  ``php/`` . Путь к этой папке необходим для <<settingUpEnvironment,настройки среды>>.


=== Настройка среды

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

Для механизма PHP 5.2 *с ориентацией на многопотоковое исполнение*:


[source,ini]
----

zend_extension_ts="<path to the php folder>/php_xdebug-<version-number>.dll"
xdebug.remote_enable=1
----

Для механизма PHP 5.2 *без ориентации на многопотоковое исполнение*:


[source,ini]
----

zend_extension_nts="<path to the php folder>/php_xdebug-<version-number>.dll"
xdebug.remote_enable=1
----

Для *любого* механизма PHP 5.3:


[source,ini]
----

zend_extension="<path to the php folder>/php_xdebug-<version-number>.dll"
xdebug.remote_enable=1
----

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


[source,ini]
----

xdebug.remote_host=127.0.0.1xdebug.remote_port=9000
; Port number must match debugger port number in NetBeans IDE Tools > Options > PHPxdebug.remote_handler=dbgp
----

Дополнительные сведения о настройке отладчика XDebug приведена link:http://www.xdebug.org/docs/install[+здесь+].

NOTE:  Убедитесь в том, что указанные пути соответствуют именам и расположению соответствующих файлов, как это определено при установке.


[start=3]
. Для проверки того, что предварительно установленный механизм PHP поддерживает использование сервера базы данных MySQL выполните следующие действия:

1. Выберите команду "Пуск" > "Панель управления".
2. На экране "Панель управления" выберите параметр "Добавление или удаление программ".
3. На экране "Добавление или удаление программ" перейдите к области "PHP <номер_версии>" и нажмите кнопку "Изменить". Последует запуск мастера настройки PHP. Нажмите кнопку "Далее".
4. На экране "Изменение, исправление или удаление" выберите команду "Изменить" и нажмите кнопку "Далее".
5. На экране "Установка веб-сервера" выберите версию сервера Apache – в рассматриваемом примере используется Apache 2.2.x Module. Нажмите кнопку "Далее".
6. На экране "Каталог конфигурации Apache" укажите каталог, в котором расположен файл настройки Apache  ``httpd.conf`` . Нажмите кнопку "Далее".
7. На экране "Выбор компонентов для установки" разверните узел "Расширения" и выберите элементы MySQL и MySQLi. Нажмите кнопку "Далее".
8. На экране "Все готово к изменению PHP <номер_версии>" выберите команду "Изменить".
9. На экране "Мастер установки PHP <номер_версии> завершен" нажмите кнопку "Готово".

link:/about/contact_form.html?to=3&subject=Feedback:%20Configuring%20PHP%20on%20Windows[+Отправить отзыв по этому учебному курсу+]


Для отправки комментариев и предложений, получения поддержки и новостей о последних разработках, связанных с PHP IDE NetBeans link:../../../community/lists/top.html[+присоединяйтесь к списку рассылки users@php.netbeans.org+].

link:../../trails/php.html[+Возврат к учебной карте PHP+]