Как запустить 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 скрипт не сохраняет файл в папку, на которую установлены права на запись для кого угодно (777).

Такое поведение может выглядеть необъяснимым, если вы не знаете о директиве open_basedir в главном конфигурационном файле php.ini. Данная директива ограничивает все файловые операции теми папками, которые указаны с ней. Пример:

open_basedir = /srv/http/:/etc/webapps/:/usr/share/webapps/:/tmp/:

Данная запись означает, что PHP скрипт может записывать файлы в папку /srv/http/, а также в папки /etc/webapps/, /usr/share/webapps/ и /tmp/.

Причём если директива open_basedir вообще не настроена (строка с ней, например, закомментирована), то PHP может записывать в любую папку, если у текущего пользователя достаточно прав на запись.

При работе в консоли PHP скрипт может пытаться сохранить файлы, например, в текущую папку — если эта папка не указана в open_basedir, но при этом сама директива open_basedir настроена, то возникнет описанная проблема: PHP не сможет записывать файлы даже в папку открытую для всех.

Чтобы избавиться от этой ошибки есть несколько вариантов:

  • добавить папку, в которую вы хотите сохранить файл, в перечень open_basedir
  • выбрать для сохранения папку уже указанную в open_basedir
  • запустить интерпретатор PHP без чтения настроек из конфигурационных файлов (в этом случае не будет учтена директива open_basedir, а также вообще все другие конфигурации

Чтобы запустить PHP скрипт без учёта настроек файла php.ini используйте опцию -n, например:

php -n скрипт.php

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

php --ini

Пример вывода:

Configuration File (php.ini) Path: /etc/php
Loaded Configuration File:         /etc/php/php.ini
Scan for additional .ini files in: /etc/php/conf.d
Additional .ini files parsed:      (none)

Заключение

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

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

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


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

7 комментариев to Как запустить PHP скрипт без веб-сервера

  1. Alexey:

    UPD:

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

  2. DMITRII:

    Спасибо добрый человек

  3. Очень полезная статья, но я к сожалению не нашла ответ на свою проблему. СУть в следующем - есть скрипт php, который на протяжении 6 лет запускался утилитой wget ежедневно в 17.00 в планировщике заданий. Потребовалось заменить сервер и теперь на новом сервере работает все, кроме этого скрипта. Поначалу "грешила" на утилиту wget, но именно этот скрипт не работает и без данной утилиты. Скрипт этот единственный из всех, находящихся на сервере, который в результате своей работы создает на сервере однц папку и удаляет другую. Знаит, проблема или в настройках нового сервера, или возможно в каких-то особенностях самого сервера? Я не сисадмин и мне сложно ориентироваться в серверах - может, кто подскажет идею? Буду очень признательна.

    • Alexey:

      wget? Это утилита для скачивания файлов. Возможно вы имеете ввиду cron?

      Возможно, скрипт перестал работать из-за перехода на новую версию PHP. Возможно, из-за настроек PHP — а именно директивы open_basedir, про которую говорится выше.

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

      php /ПУТЬ/ДО/СКРИПТА.php
      
  4. Alexey, спасибо за реакцию, ошибка все время одна: 500 internal error of server. Утилита Wget в основном предназначена для скачивания файлов - Вы правы. Но эта утилита так же и может запустить на выполнение удаленно скрипты php (чем она собственно и занималась ежедневно в автоматическом режиме без чьего-либо вмешптельства). Утилита практически универсальна - она работает и для Windowsи для Linux, разработана она лет эдак двадцать назад. И вот теперь - ужу два месяца "бьюсь" и не могу понять, что случилось. Мне кажется, что все дело в настройках нового сервера.

    • Alexey:

      Думаю, что ошибку «500 internal error of server» вам показывает веб-сервер, например, в веб-браузере. Или утилита wget может показывать это сообщение.

      А я имел ввиду, что вам на удалённой машине, где проблемный скрипт, нужно запустить этот скрипт в командной строке. Например, подключиться по SSH и запустить. Наверное, вам эти слова ничего не говорят — но кто-то же настраивал вам сервер? Попросите его запустить этот скрипт в командной строке.

      Ещё один вариант — посмотреть логи (журнал) ошибок удалённого веб-сервера — туда тоже должны писаться критические ошибки PHP скриптов.

      А сообщение «500 internal error of server» показывает при любых ситуациях, когда скрипт на сервере завершился с любой ошибкой — то есть по этой информации что-то определённое сказать невозможно.

      • Alexey, спасибо Вам большое еще раз! На удаленной машине я пробую запустить свой скрипт через консоль cmd.exe. Да, ВЫ правы, надо попробовать запустить этот скрипт непосредственно на сервере в командной строке, но сисадмин, настроивший новый сервер, после этого уволился, теперь другой, который еще пока не очень в курсе. Пойду завтра к нему. Проблемы с PHP в целом исключаются потому что на этом сервере лежит множество других скриптов, которые прекрасно работают. Но именно этот скрипт отличается от других тем, что в процессе его работы создаются/удаляются файлы на сервере и конечно об отсутствии места на сервере речи не идет.

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

Ваш адрес email не будет опубликован. Обязательные поля помечены *