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

Щоб встановити 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 встановлений і активований. Інструкції з встановлення ви можете знайти в репозиторії Zephir Parser.

Реліз PHAR

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

Composer

PHAR не доступний до версії 0.11.4, тому якщо вам потрібна старіша версія, ви можете використовувати Composer одним з двох способів:

Composer як глобальна програма

composer global require phalcon/zephir

На даний момент існує два підходи до запуску Zephir. Перший, переконайтеся, що ${COMPOSER_HOME}/vendor/bin знаходиться у вашому $PATH, Zephir повинен бути доступний в командному рядку за допомогою команди zephir. Другий, замість цього можна використовувати команду composer global exec zephir.

Залежність проекту

composer require phalcon/zephir

Для запуску Zephir використовуйте команду composer exec zephir в проекті з встановленим Zephir як показано вище. (Крім того, як альтернативу ви можете запустити vendor/bin/zephir

Git Clone

На останок, ви можете просто склонувати останні теги з GitHub, встановити залежності й запустити Zephir:

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

Для запуску Zephir з використанням цього варіанту вам потрібно або використовувати шлях до zephir/zephir, або створити символьне посилання в каталозі $PATH.

Тестування встановлення

Перевірте, чи доступний Zephir з будь-якого каталогу за допомогою такої команди:

zephir help