Встановлення
Щоб встановити 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 -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
Також переконайтеся, що у вас встановлені пакунки бібліотек для розробки PHP:
phpize -v
Configuring for:
PHP Api Version: 20170718
Zend Module Api No: 20170718
Zend Extension Api No: 320170718
Вам не обов’язково потрібно отримати такий самий вивід. Однак важливо, щоб ці команди були доступні для початку розробки на Zephir.
Встановлення Zephir
Для початку переконайтеся, що Zephir parser встановлений і активований. You can follow this tutorial.
Використовуючи 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
. Ви, ймовірно, захочете позбутися від розширення .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
На останок, ви можете просто склонувати останні теги з GitHub, встановити залежності й запустити Zephir:
git clone --depth 1 -b $(git ls-remote https://github.com/zephir-lang/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