Установка PHP 7.1 в Windows. Командная строка

В htmlAcademy стартовал первый базовый интенсив по PHP и я работаю на нем наставником. Студентам в рамках интенсива предстоит поднять рабочее окружение и это заметка нацелена упростить эту нелегкую для новичка задачу. Есть разные способы поднятия полноценного 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, ярлык доступен в меню «Стандартные») и введите команду:

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

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

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

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

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

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

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

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

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

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

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

Можно пойти немного дальше и ассоциировать расширение .php с интерпретатором, т.е. сделать все файлы с расширением php исполняемым по умолчанию. Для этого вводим в консоле несколько команд:

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

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

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

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

Php function new windows

Представляет пользовательский интерфейс окна

Обзор классов

Свойства

Содержит элементы управления, не следует использовать напрямую

Содержание

• UI\Window::add — Добавить элемент управления
• UI\Window::__construct — Создать новый объект Window
• UI\Window::error — Показать блок ошибки
• UI\Window::getSize — Получить размер окна
• UI\Window::getTitle — Получить заголовок
• UI\Window::hasBorders — Определение рамки
• UI\Window::hasMargin — Определение полей
• UI\Window::isFullScreen — Определение полного экрана
• UI\Window::msg — Показать блок сообщения
• UI\Window::onClosing — Callback-функция закрытия
• UI\Window::open — Открыть диалоговое окно
• UI\Window::save — Сохранить диалоговое окно
• UI\Window::setBorders — Использование рамок
• UI\Window::setFullScreen — Использование полного экрана
• UI\Window::setMargin — Использование поля
• UI\Window::setSize — Установить размер
• UI\Window::setTitle — Заголовок окна

User Contributed Notes 1 note

This is a example to wizard layout in UI library:

/*
* Wizard sample layout builded with PHP UI
*/

use UI \ Window ;
use UI \ Size ;
use UI \ Controls \ Button ;
use UI \ Controls \ Grid ;
use UI \ Controls \ Box ;
use UI \ Controls \ Form ;
use UI \ Controls \ Entry ;
use UI \ Controls \ Label ;

/*
* The window
*/
$window = new Window ( ‘Wizard Sample Layout’ , new Size ( 640 , 480 ), TRUE );
$window -> setMargin ( true );

/*
* Wizard content (sample)
*/
$content = new Form ();
$content -> setPadded ( true );
$content -> append ( ‘User:’ , new Entry ());
$content -> append ( ‘Password:’ , new Entry ( Entry :: Password ));

/*
* Layout to title, content and buttons
*/
$grid = new Grid ();
$grid -> setPadded ( false );

/*
* Title
*/
$grid -> append (new Label ( ‘Wizard Sample’ ), 0 , 0 , 6 , 1 , true , Grid :: Fill , false , Grid :: Fill );

/*
* Append content
*/
$grid -> append ( $content , 0 , 1 , 6 , 1 , false , Grid :: Fill , true , Grid :: Fill );

/*
* Left buttons
*/
$left_box = new Box ( Box :: Horizontal );
$left_box -> append (new Button ( ‘&About’ ));
$left_box -> append (new Button ( ‘&Help’ ));

/*
* Right buttons
*/
$right_box = new Box ( Box :: Horizontal );
$right_box -> append (new Button ( ‘&Back’ ));
$right_box -> append (new Button ( ‘&Forward’ ));
$right_box -> append (new Button ( ‘&Close’ ));

/**
* Append buttons
*/
$grid -> append ( $left_box , 0 , 2 , 1 , 1 , true , Grid :: Start , false , Grid :: Fill );
$grid -> append ( $right_box , 5 , 2 , 1 , 1 , true , Grid :: End , false , Grid :: Fill );

/*
* Append layout and show.
*/
$window -> add ( $grid );

COM и .Net (Windows)

User Contributed Notes 6 notes

If you are trying to get the properties of a Word document opened via COM object, you may need to define some constants in your script like so.

( ‘wdPropertyTitle’ , 1 );
define ( ‘wdPropertySubject’ , 2 );
define ( ‘wdPropertyAuthor’ , 3 );
define ( ‘wdPropertyKeywords’ , 4 );
define ( ‘wdPropertyComments’ , 5 );
define ( ‘wdPropertyTemplate’ , 6 );
define ( ‘wdPropertyLastAuthor’ , 7 );

$word = new COM ( «word.application» ) or die ( «Could not initialise MS Word object.» );
$word -> Documents -> Open ( realpath ( «Sample.doc» ));
$Author = $word -> ActiveDocument -> BuiltInDocumentProperties ( wdPropertyAuthor );

(From?) PHP 5.4.5 for Windows:

If you are seeing this in your error log:

Fatal error: Class ‘COM’ not found

You require this in php.ini:

Previously it was compiled as built-in on the Windows build. I assume this has happened because the com extension can now be built as a shared component.

When you work with MS Excel, Word, . and other applications, never forget that COM doesn’t know their predefined constants, thus if you want to do sth. that would look like this in VB:

With myRange.Borders(xlEdgeBottom)
.LineStyle = xlContinuous
.Weight = xlThin
.ColorIndex = xlAutomatic
End With

you should either use numbers or define constants above, like this:

( ‘xlEdgeBottom’ , 9 );
define ( ‘xlContinuous’ , 1 );
define ( ‘xlThin’ , 2 );
define ( ‘xlAutomatic’ , — 4105 );

$ex = new COM ( «Excel.Application» , NULL , CP_UTF8 ) or Die ( «Did not instantiate Excel» );
$wb = $ex -> Application -> Workbooks -> Add ();
$ws = $wb -> Worksheets ( 1 );

$xra = $ws -> Range ( «A1:A6» );

$bs = $xra -> Borders ( xlEdgeBottom );
$bs -> LineStyle = xlContinuous ;
$bs -> Weight = xlThin ;
$bs -> ColorIndex = xlAutomatic ;

?>

It is pointless to try to use text strings, i.e.

= $xra -> Borders ( ‘xlEdgeBottom’ );
$bs -> Weight = ‘xlThin’ ;

?>

this will cause an error: Unable to set property Weight of class Border .

Extracting text from Word Documents via PHP and COM

= new COM ( «word.application» ) or die ( «Could not initialise MS Word object.» );
$word -> Documents -> Open ( realpath ( «Sample.doc» ));

// Extract content.
$content = (string) $word -> ActiveDocument -> Content ;

$word -> ActiveDocument -> Close ( false );

$word -> Quit ();
$word = null ;
unset( $word );
?>

Add hyperlink at a Word Document’s bookmark

// Create COM instance to word
function clsMSWord ( $Visible = false )
<
$this -> handle = new COM ( «word.application» ) or die( «Unable to instanciate Word» );
$this -> handle -> Visible = $Visible ;
>

function WriteHyperlink ( $Bookmark , $Path , $Text )
<
$objBookmark = $this -> handle -> ActiveDocument -> Bookmarks ( $Bookmark );
$range = $objBookmark -> Range ;
$objHyperlink = $this -> handle -> ActiveDocument -> Hyperlinks ;
$objHyperlink -> add ( $range , $Path , «» , «» , $Text );

Here is some helpful advice for people attempting to use COM with Microsoft MapPoint 2006 or 2009 with PHP.

If you are using apache, it MUST be running under the same credentials as a desktop user that has already installed/run mappoint or modifiy the service and select the «Allow Service to Interact with Desktop» option. Otherwise, it won’t work due to the EULA popup having to be accepted. Mappoint 2004 works just fine, this only applies to 2006 and 2009.

For troubleshooting, the error that appears in the System event viewer is:
The server <31851f82-afe6-11d2-a3c9-00c04f72f340>did not register with DCOM within the required timeout.

The error generated by PHP, if you happen to get lucky and let the COM() function timeout by cranking up set_time_limit() timeout is:
( 1000 ) ;

$mapoint = new COM ( «MapPoint.Application» ) or die( «Unable to instantiate Mappoint COM object» );

?>
Generates:
Fatal error: Uncaught exception ‘com_exception’ with message ‘Failed to create COM object `MapPoint.Application’: Server execution failed ‘ in [somefile.php]:9 Stack trace: #0 [somefile.php](9): com->com(‘MapPoint.Applic. ‘) #1

thrown in [somefile.php] on line 9

Also, if you have multiple versions of MapPoint installed, you will need to run:
c:\path\to\mappoint\MapPoint.exe /registerserver

(using the correct folder path) to select the right version of the com object to use. Gooood luck!