Командная строка Zephir
После установки Zephir вы будете использовать команду zephir
для управления компилятором Zephir для ваших проектов. Эта и некоторые последующие главы — о самой команде и о том, как её использовать, чтобы понять что она выводит.
Начиная с Zephir 0.11.7, компилятор использует stderr
для отображения сообщений об ошибках. Это означает, что вы можете обрабатывать вывод ошибок отдельно от обычных:
zephir generate 2> errors.log 1> /dev/null
zephir api
Генерирует HTML API на основе классов, доступных в расширении
--backend=BACKEND
: Бэкэнд, используемый для генерации HTML API (по умолчанию:ZendEngine3
)--path=PATH
(или-p PATH
): Тема API, которая будет использоваться--output=OUTPUT
(или-o OUTPUT
): Директория вывода для генерации темы--options=OPTIONS
: Настройки темы--url=URL
: Базовый URL, который будет использоваться при создании ссылок
zephir build
Это мета-команда, которая вызывает команды generate
, compile
и install
. Для дополнительной информации по этим командам, о поддерживаемых опциях и поведении каждой см. описание ниже.
zephir clean
Удаляет все объектные файлы, созданные для расширения
zephir compile
Компиляция Zephir-расширения
--backend=BACKEND
: Бэкенд, используемый для сборки расширения (по умолчанию:ZendEngine3
)--dev
: Сборка расширения в режиме разработки--no-dev
: Сборка расширения в режиме производства
Использовании опции --dev
принудительно соберёт и установит расширение в режиме разработки (отладочные символы, без оптимизации). Расширение, скомпилированное с использованием символов отладки, можно пропускать через через отладчик и вывод отладочной информации будет понятен пользователю. Эти символы отладки также значительно увеличивают размер программы или библиотеки.
ПРИМЕЧАНИЕ: Режим разработки Zephir будет тихо включен, если ваша версия PHP была скомпилирована с использованием отладочной конфигурации.
В некоторых случаях мы хотели бы получить готовое расширение для производства, даже если бинарный PHP-файл был скомпилирован с конфигурацией отладки. Чтобы этого достичь используйте --no-dev
.
Кроме того, любая из доступных опций конфигурационного файла после extra
также может быть передана в качестве опции, например --export-classes
и --indent=tabs
.
zephir fullclean
Очищает все объектные файлы, созданные для расширения (включая файлы, созданные phpize)
zephir generate
Генерирует Си-код из Zephir-кода
--backend=BACKEND
: Бэкенд, используемый для сборки расширения (по умолчанию:ZendEngine3
)
zephir help
Выводит справку для команды
zephir init
Инициализация Zephir-расширения zephir init <namespace>
namespace
: Пространство имён расширения--backend=BACKEND
: Бэкенд, используемый для создания расширения (по умолчанию:ZendEngine3
)
zephir install
Устанавливает расширение в директорию расширений (может потребовать пароль суперпользователя)
--dev
: Установка расширения в режиме разработки--no-dev
: Установка расширения в режиме производства
zephir list
Список команд
zephir stubs
Генерирует заглушки, которые могут использоваться в PHP IDE
--backend=BACKEND
: Бэкенд, используемій для генерации заглушек (default:ZendEngine3
)