Как запустить PHP скрипт без веб-сервера

Интерпретатор PHP стал неотъемлемой частью практически каждого веб-сервера. Подавляющее большинство веб-приложений написаны на PHP. Поэтому технология PHP очень стойко у многих ассоциируется именно с веб окружением, со средой веб-сервера. Но на самом деле, запускать скрипты PHP можно без веб-браузера. Речь идёт не о специально созданных как веб приложения программах, таких как WordPress, phpMyAdmin, гостевые книги, форумы и прочее. Такие скрипты специально создавались для работы в условиях веб-сервера и для вывода результатов в веб-браузер. Вряд ли удастся полноценно с ними работать в командной строке. Речь идёт о консольных программах на PHP, которые могут выполнять различные, не обязательно связанные с веб сервисами функциями. По сути, PHP является очень гибким языком с хорошим набором классов и на нём можно написать консольную программу под любые функции. Либо ядро программы (так называемый бэк-энд) к которому будер обращаться графический пользовательский интерфейс.

Ещё запуск PHP скриптов в консоли удобен для изучающих язык. Хотя кто-то может с этим не согласиться. При выводе результатов в консоль, а также при передаче аргументов в скрипт, не нужно уделять внимание HTML. Но если вы изучаете PHP для создания веб-приложений и онлайн сервисов, то вам всё равно потом придётся доучивать особенности передачи аргументов из веб-браузера (в окружении сервера), а также HTML вообще, поскольку весь вывод скриптов нужно будет оформлять для браузеров пользователей.

Как запустить PHP скрипт в командной строке Linux

У вас должен быть установлен PHP, к счастью, в Linux интерпретатор PHP устанавливается очень просто, а в некоторых дистрибутивах присутствует по умолчанию. Если у вас его ещё нет, то установите его одной из следующей команд.

В Debian, Kali Linux, Linux Mint, Ubuntu:

sudo apt install php

В Arch Linux, BlackArch:

sudo pacman -S php

Установка полного веб-сервера в Linux Mint описана здесь, в Ubuntu здесь, в Arch Linux/BlackArch здесь, а в Kali Linux он уже установлен, про то, как его запустить здесь.

В остальном запуск скриптов в консоли, в том числе опции запуска, в Linux и Windows идентичные.

Если вы совсем новичок в Linux, то также смотрите Азы работы в командной строке.

Как запустить PHP скрипт в командной строке Windows

Если вы знакомы с запуском консольных программ в Windows или хотя бы в Linux, то для вас всё совсем просто — везде программы запускаются примерно одинаково. Но начнём по порядку для новичков.

Если вы хотите не только возможность запускать PHP из командной строки, но и полноценный веб-сервер Apache + PHP + MySQL на Windows, то выполните установку по этой статье.

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

Если вы часто будете запускать PHP скрипты из командной строки Windows, то настоятельно рекомендуется Добавить путь до PHP в переменную окружения PATH в Windows. Благодаря этому не придётся каждый раз указывать полный путь до файла php.exe.

Теперь, когда PHP установлен и путь до php.exe добавлен в переменную окружения Windows, открываем командную строку, для этого нажмите сочетание клавиш Win+x и выберите Windows PowerShell.

Для проверки, что нормально установилось, посмотрим справку по PHP:

php -h

На самом деле, мы запускаем файл php.exe, но расширение можно отбросить. То есть предыдущая запись эквивалентна

php.exe -h

Справка и опции запуска PHP скриптов в командной строке

Справка содержит опции для разнообразных вариантов запуска файлов .php в командной строке, поэтому приведу её перевод полностью.

Использование:

   php [опции] [-f] <файл> [--] [аргументы...]
   php [опции] -r <код> [--] [аргументы...]
   php [опции] [-B <начало_кода>] -R <файл> [-E <конец_кода>] [--] [аргументы...]
   php [опции] [-B <начало_кода>] -F <файл> [-E <конец_кода>] [--] [аргументы...]
   php [опции] -S <адрес>:<порт> [-t docroot] [router]
   php [опции] -- [аргументы...]
   php [опции] -a

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

Опции:

  -a               Запустить интерактивный шелл (оболочку)
  -c <путь>|<файл> Искать файл php.ini в этой директории
  -n               Не будут использоваться конфигурационные (ini) файлы
  -d foo[=bar]     Установить INI запись для значения 'bar'
  -e               Сгенерировать расширенную информацию для отладчика/профайлера
  -f <файл>        Разобрать и выполнить <файл>.
  -h               Справка
  -i               Информация о PHP
  -l               Только проверка синтаксиса (lint)
  -m               Показать скомпилированные модули
  -r <code>        Запустить PHP <код> без использования тэгов скрипта <?..?>
  -B <начало_кода> Запустить PHP <начало_кода> перед обработкой строк ввода
  -R <код>         Запустить PHP <код> для каждой строки ввода
  -F <файл>        Разобрать и выполнить <файл> для каждой строки ввода
  -E <конец_кода>  Запустить PHP <конец_кода> после обработки всех строк ввода
  -H               Спрятать любые переданные аргументы от внешних инструментов.
  -S <адрес>:<порт> Запустить встроенный веб-сервер.
  -t <docroot>     Указать корневую папку документов <docroot> для встроенного веб-сервера.
  -s               Подсветка для HTML кода.
  -v               Номер версии
  -w               Вывести исходник с убранными комментариями и белыми пробелами.
  -z <файл>        Загрузить расширение Zend <файл>.

  args...          Передаваемые в скрипт аргументы. Используйте -- args когда первый аргумент
                   начинается с — или скрипт считывается с stdin (стандартного ввода)

  --ini            Показать имена конфигурационных файлов

  --rf <имя>      Показать информацию о функции <имя>.
  --rc <имя>      Показать информацию о классе <имя>.
  --re <имя>      Показать информацию о расширении <имя>.
  --rz <имя>      Показать информацию о расширении Zend <имя>.
  --ri <имя>      Показать конфигурацию для расширения <имя>.

Как запустить .php скрипт в командной строке Windows и Linux

Для запуска .php файла в консоли Windows используется следующая команда:

php -f путь\до\файла.php

Опцию -f можно отбросить, то есть предыдущая и следующая команды равнозначны:

php путь\до\файла.php

Я создал тестовый файл, который расположен по пути C:\Users\Alex\Documents\PHP\test.php тогда я могу запустить его в PHP так:

php -f C:\Users\Alex\Documents\PHP\test.php

или так:

php C:\Users\Alex\Documents\PHP\test.php

Как передать аргументы PHP скрипту в командной строке

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

php путь\до\файла.php 'аргумент1' 'аргумент2' 'аргумент3' 'аргумент_n'

Пример запуска PHP скрипта с тремя аргументами:

php C:\Users\Alex\Documents\PHP\test.php 'Alex' 'hackware.ru' 'Admin'

Как в PHP скрипте обратиться к аргументам

Переданные аргументы содержаться в массиве $argv. Причём, порядковый номер аргумента соответствует номеру в массиве. То есть первый аргумент будет помещён в $argv[1], второй в $argv[2] и так далее.

Самый первый элемент массива $argv[0] содержит полный путь до запускаемого скрипта.

Содержимое файла test.php:

<?php

echo 'Name: ' . $argv[1] . PHP_EOL;
echo 'Web site: ' . $argv[2] . PHP_EOL;
echo 'Status: ' . $argv[3] . PHP_EOL;

Запустим его и передадим в скрипт три аргумента:

php C:\Users\Alex\Documents\PHP\test.php 'Alex' 'hackware.ru' 'Admin'

Как в PHP получить данные от пользователя в консоли

Благодаря передаваемым аргументам, скрипт может выполнять действия не только с прописанными в нём данными, но и с другими значениями, указанными при запуске скрипта.


Кстати, при работе в окружении веб-сервера, то есть когда PHP скрипт выполняет задачи для веб-сайта, возможность передать ему аргументы реализована с помощью HTTP методов GET и POST. Эти аргументы передаются перед запуском скрипта и уже после запуска PHP скрипта, новые данные отправить нельзя — нужно ждать завершения работы программы, и при необходимости запустить её ещё раз с новыми данными.

Во время работы скрипта может потребоваться ввод новых данных, в консоли это достигается с помощью строки запроса, в которую пользователь может ввести значение и нажать Enter для передачи его скрипту. В контексте веб-сайта такой возможности — передать данные уже во время выполнения скрипта — нет. То есть консольный запуск PHP скриптов с аргументами не только проще (не нужно возиться с HTML формой), но и даже более гибкий.

В PHP для запроса пользователю используется функция readline.

Эта функция одинаково работает и на Windows и на Linux. Причём на Linux она имеет интерактивные возможности Bash, например, сохраняет историю ввода, к которой можно вернуться с помощью стрелок. На Windows эта возможность появилась начиная с PHP 7.1.

Если сильно надо, можно настроить автозавершение вводимых данных. Все функции GNU Readline рассмотрены здесь. Я же коснусь только readline, которая считывает введённую пользователем строку. С этой функцией можно указать один опциональный аргумент — строку, которая будет показана пользователю в приглашении.

Пример консольного PHP скрипта, которые запрашивает у пользователя данные в приглашении командной строки:

<?php

$len_min = readline("Минимальное количество символов в пароле: ");
$len_max = readline("Максимальное количество символов в пароле: ");
$base = readline("Основа пароля (0 - цифры; 1 - маленькие буквы; 2 - большие буквы): ");

echo "Полученные исходные данные: \r\nДлина пароля от $len_min до $len_max символов ";
switch ($base) {
    case 0:
        echo "и основой пароля являются цифры.";
        break;
    case 1:
        echo "и основой пароля являются маленькие буквы.";
        break;
    case 2:
        echo "и основой пароля являются большие буквы.";
        break;
}

Проверка синтаксиса скрипта PHP в командной строке

С опцией -l будет проверен синтаксис, то есть не нарушены ли правила кода PHP, но сам файл скрипт не будет выполнен:

Пример:

php -l C:\Users\Alex\Documents\PHP\test.php
No syntax errors detected in C:\Users\Alex\Documents\PHP\test.php

Или если в файле есть ошибки:

php -l C:\Users\Alex\Documents\PHP\test.php
PHP Parse error:  syntax error, unexpected end of file in C:\Users\Alex\Documents\PHP\test.php on line 20

Parse error: syntax error, unexpected end of file in C:\Users\Alex\Documents\PHP\test.php on line 20
Errors parsing C:\Users\Alex\Documents\PHP\test.php

Выполнение команд PHP в интерактивном режиме

Если вам это нужно, то можно работать с интерпретатором PHP в интерактивном режиме, вводя код построчно. При этом код выполняется после нажатия кнопки Enter, но значения переменных сохраняются в рамках одной сессии. То есть вы можете присвоить значение какой-либо переменной, а затем использовать его в других строках.

Для запуска интерактивного шелла:

php -a

Запуск отдельных команд PHP

Для выполнения отдельных команд используйте опцию -r:

php -r 'echo 2**100;'

Запуск встроенного в PHP веб-сервера

В PHP есть свой собственный веб-сервер! Если вам очень надо, можно вообще обойтись без сторонних серверов для каких-то определённых задач.

Опции следующие:

  -S <адрес>:<порт> Запустить встроенный веб-сервер.
  -t <docroot>     Указать корневую папку документов <docroot> для встроенного веб-сервера.

Допустим, в качестве прослушиваемого IP адреса я хочу установить 127.0.0.1, в качестве прослушиваемого порта — 84, корневая папка документов веб-сервера у меня расположена в C:\Users\Alex\Documents\PHP\, тогда команда запуска следующая:

php -S 127.0.0.1:84 -t C:\Users\Alex\Documents\PHP\

В этой папке у меня файл test_2.php со следующим содержимым:

<?php

print ("<table border=\"1\">
<thead>
<tr>
<th>Параметр</th>
<th>Значение</th>
</tr>
</thead>
<tbody>

<tr>
<td>Удалённый IP</td>
<td>" . $_SERVER ['REMOTE_ADDR'] . "</td>
</tr>

<tr>
<td>Пограммы сервера</td>
<td>" . $_SERVER ['SERVER_SOFTWARE'] . "</td>
</tr>

<tr>
<td>Язык</td>
<td>" . $_SERVER ['HTTP_ACCEPT_LANGUAGE'] . "</td>
</tr>

<tr>
<td>Откуда пришёл</td>
<td>" . $_SERVER ['HTTP_REFERER'] . "</td>
</tr>

<tr>
<td>Браузер (или что там)</td>
<td>" . $_SERVER ['HTTP_USER_AGENT'] . "</td>
</tr>

<tr>
<td>Метод запроса</td>
<td>" . $_SERVER ['REQUEST_METHOD'] . "</td>
</tr>

<tr>
<td>Время запроса</td>
<td>" . $_SERVER ['REQUEST_TIME'] . "</td>
</tr>

<tr>
<td>Строка запроса</td>
<td>" . $_SERVER ['QUERY_STRING'] . "</td>
</tr>

<tr>
<td>Заголовок запроса</td>
<td>" . $_SERVER ['HTTP_ACCEPT'] . "</td>
</tr>

<tr>
<td>Адрес запроса</td>
<td>" . $_SERVER ['REQUEST_URI'] . "</td>
</tr>

<tr>
<td>Название сервера</td>
<td>" . $_SERVER ['SERVER_NAME'] . "</td>
</tr>

</tbody>
</table>");

Открываю в веб-браузере адрес http://127.0.0.1:84/test_2.php

В консоли вижу:

В самом браузере:

Можно было бы из спортивного интереса попробовать во встроенном веб-сервере запустить WordPress, но что-то лень…

Получение справки в командной строке

Для получения справки о функциях PHP прямо в командной строке используется опция --rf.

Например, я хочу узнать о readline:

php --rf readline
Function [  function readline ] {

  - Parameters [1] {
    Parameter #0 [  $prompt ]
  }
}

Ну как-то так… а чего вы хотели — это же консоль.

Информация о readfile:

 php --rf readfile
Function [  function readfile ] {

  - Parameters [3] {
    Parameter #0 [  $filename ]
    Parameter #1 [  $flags ]
    Parameter #2 [  $context ]
  }
}

Насколько я понял, в строке Parameters в фигурных скобках пишется количество аргументов функции, строка required означает, что аргумент обязательный, а строка optional — что аргумент опциональный. О функции аргументов иногда можно догадаться по их имени, например, $filename. Информации о том, какое действие выполняет функция, видимо, нет.

Опции для разработчика

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

  -s               Подсветка для HTML кода.
  -w               Вывести исходник с убранными комментариями и белыми пробелами.

Вывод информации о PHP

Для показа информации о PHP имеются следующие три опции:

  -i               Информация о PHP
  -v               Номер версии
  --ini            Показать имена конфигурационных файлов

Опция -i — это эквивалент phpinfo, но для консоли.

Заключение

Запуск PHP скриптов в командной строке — это альтернатива их запуску через веб-сервер. Работа в консоли может быть удобна при обучении языку программированию PHP или для отладки определённых функций, даже если в дальнейшем эти функции и скрипты будут работать на веб-сервере.

Скрипт на PHP может быть альтернативой скрипту на Bash, особенно если нужно использовать СУБД (MySQL, SQLite) — с которыми через Bash работать тяжело, либо для использования возможностей PHP по работе с текстом в разметке XML, JSON — что в Bash также не очень удобно.

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

Вы уже знаете о факультете информационной безопасности от GeekBrains? Комплексная годовая программа практического обучения с охватом всех основных тем, а также с дополнительными курсами в подарок. По итогам обучения выдаётся свидетельство установленного образца и сертификат. По этой ссылке специальная скидка на любые факультеты и курсы!

Рекомендуется Вам:

Добавить комментарий

Ваш e-mail не будет опубликован.