Командная строка 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)