Установка

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

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

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

  • Zephir parser >= 1.3.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.3.7 (cli) (built: Jul 14 2019 17:24:22) ( ZTS DEBUG )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.3.7, Copyright (c) 1998-2018 Zend Technologies
    with Zend OPcache v7.3.7, Copyright (c) 1999-2018, by Zend Technologies
    with Xdebug v2.7.2, Copyright (c) 2002-2019, by Derick Rethans

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

phpize -v
Configuring for:
PHP Api Version:         20180731
Zend Module Api No:      20180731
Zend Extension Api No:   320180731

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

Установка Zephir

Для начала убедитесь что Zephir parser установлен и активирован. You can find installation instructions in the Zephir Parser repository.

Release PHAR

The recommended, officially supported, and easiest-to-use way to install Zephir is to simply grab the latest release PHAR from GitHub, and download/move it to somewhere in your $PATH. (You’ll probably also want to rename it to drop the .phar extension, so you can run it as zephir instead of zephir.phar.)

Composer

The PHAR isn’t available before 0.11.4, so if you need an older version, you can use Composer, in one of two ways:

Global Composer Application

composer global require phalcon/zephir

There are two approaches to running Zephir at this point. The first is to ensure that ${COMPOSER_HOME}/vendor/bin is in your $PATH, then Zephir should be available as zephir on the command line. The second is to simply use composer global exec zephir instead.

Project Dependency

composer require phalcon/zephir

Use composer exec zephir within the project you installed Zephir in, above, to run it. (Alternately, you can still run vendor/bin/zephir.)

Git Clone

Finally, you can also simply clone the latest tag from GitHub, install the dependencies, and run Zephir from there:

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

You’ll need to either use the path to zephir/zephir, or create a symlink in a directory in your $PATH, to run Zephir using this option.

Протестируйте Zephir

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

zephir help