Установка

Следуйте инструкциям ниже, чтобы установить Zephir:

Системные требования

Чтобы собрать расширение под PHP и использовать Zephir нужно:

  • Zephir parser >= 1.1.0
  • Один из следующих C компиляторов: gcc >= 4.4, clang >= 3.0, Visual C++ >= 11 или Intel C++. Рекомендуется gcc 4.4 или старше
  • re2c 0.13.6 или старше
  • Заголовочные файлы PHP и инструменты разработчика

Для систем на базе Linux, вам понадобится также:

  • GNU make 3.81 или старше
  • autoconf 2.31 или старше
  • automake 1.14 или старше
  • libpcre3
  • Пакет build-essential, если вы используете gcc в Ubuntu (и, вероятно, в других дистрибутивах)

В Ubuntu эти пакеты можно поставить так:

sudo apt-get update
sudo apt-get install git gcc make re2c php php-json php-dev libpcre3-dev build-essential

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

Так как Zephir написан на PHP, вам нужно установить последнюю версию PHP. PHP должен быть доступен из консоли:

php -v
PHP 7.2.17-0ubuntu0.19.04.1 (cli) (built: Apr 18 2019 18:01:25) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
    with Zend OPcache v7.2.17-0ubuntu0.19.04.1, Copyright (c) 1999-2018, by Zend Technologies
    with Xdebug v2.6.1, Copyright (c) 2002-2018, by Derick Rethans

Также проверьте, доступны ли инструменты для сборки расширений:

phpize -v
Configuring for:
PHP Api Version:         20170718
Zend Module Api No:      20170718
Zend Extension Api No:   320170718

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

Установка Zephir

Для начала убедитесь, что расширение Zephir Parser установлено и активировано. За подробностями по его установке обратитесь к соответствующему руководству.

Используя PHAR

Рекомендованный, официальной поддерживаемый и простой в использовании способ установки Zephir заключается в скачивании PHAR-файла со страницы GitHub релизов и указании пути к нему в переменной окружения $PATH. Вы, вероятно, также захотите избавиться от расширения .phar, чтобы запускать его как zephir, а не zephir.phar.

Используя Composer

PHAR версия Zephir не доступна до версии 0.11.4. Так что, если вам нужна более ранняя версия компилятора Zephir, вы можете использовать Composer одним из двух способов:

Как глобальное Composer приложение

composer global require phalcon/zephir

При выборе такого способа установки существует два способа запуска Zephir. Первый заключается в том, чтобы добавить путь ${COMPOSER_HOME}/vendor/bin в переменную окружения $PATH. Тогда компилятор будет доступен для запуска через командную строку при помощи команды zephir. Второй способ заключается в использовании команды composer global exec zephir.

Как локальная зависимость в проекте

composer require phalcon/zephir

Для запуска Zephir используйте команду composer exec zephir в проекте с установленным Zephir как показано выше (в качестве альтернативы используйте команду vendor/bin/zephir).

Используя Git

Наконец, вы можете склонировать последнюю версию из GitHub, установить зависимости и запустить Zephir как показано ниже:

git clone --depth 1 -b $(git ls-remote https://github.com/phalcon/zephir 0.11.* | sort -t/ -k3 -Vr | head -n1 | awk -F/ '{ print $NF }') https://github.com/phalcon/zephir
composer install

Для запуска Zephir с использованием этого варианта вам нужно либо использовать путь к zephir/zephir, либо создать символическую ссылку в каталоге $PATH.

Проверка установки

Проверьте, доступен ли Zephir из любой директории следующей командой:

zephir list