Встановлення

Щоб встановити 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 -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

Також переконайтеся, що у вас встановлені пакунки бібліотек для розробки PHP:

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 help