004 Установка
Системные требования
Чтобы собрать расширение под 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.0.8 (cli) (built: Jun 26 2016 00:59:31) ( NTS ) Copyright (c) 1997-2016 The PHP Group Zend Engine v3.0.0, Copyright (c) 1998-2016 Zend Technologies with Zend OPcache v7.0.8, Copyright (c) 1999-2016, by Zend Technologies
Также проверьте, доступны ли dev-инструменты для сборки расширений:
$ phpize -v Configuring for: PHP Api Version: 20151012 Zend Module Api No: 20151012 Zend Extension Api No: 320151012
Вам не обязательно нужно получить точно такой же вывод. Однако важно, чтобы эти команды были доступны для начала разработки на Zephir.
Установка Zephir
С использованием Git
Для начала убедитесь что Zephir parser установлен и активирован. За подробностями обратитесь к следующему руководству.
Склонируйте репозиторий Zephir:
$ git clone https://github.com/phalcon/zephir
Чтобы скомпилировать и установить Zephir выполните следующие команды:
$ cd zephir $ ./install -c
Последнее, что вам необходимо сделать, это убедиться, что у вас включены все необходимые расширения и установлены все зависимости:
composer install
Этот шаг не является обязательным для версии 0.10.x, однако он станет обязательным для последующих версий.
Протестируйте Zephir
Проверьте, доступен ли Zephir из любой директории командой:
$ zephir help
Руководство по установке / использованию Zephir (Windows)
В этом руководстве объясняется, как использовать zephir с помощью операционной системы Windows. Некоторые части являются необязательными, если у вас определенная версия PHP. Части, которые необходимы только для конкретной версии PHP, помечены как таковые. Требования к PHP-версии отмечены с использованием [ ]
Требования к ПО [PHP 7.0 или позже]
- Install Visual Studio 2017 (You should start it and activate it)
Требования к программному обеспечению
- Установка PHP (NTS)
- Загрузите и извлеките его
- Убедитесь, что он находится в PATH, как показано ниже:
setx path "%path%;c:\path-to-php\"
Переменную PATH лучше модифицировать через графический интерфейс в свойствах компютера, во избежания порчи системы.
- Установите PHP SDK для PHP 5.6(в настоящее время
php-sdk-binary-tools-20110915.zip
является новейшим) -
Установите PHP SDK для PHP 7.0+
setx php_sdk "c:\path-to-php-sdk"
-
Скачать PHP Developer Pack(NTS!) (или построить его самостоятельно с опцией
--enable-debug --disable-zts
иnmake build-devel
или простоnmake snap
с помощью PHP-SDK)
setx php_devpack "c:\path-to-extracted-devpack"
Установка Zephir
-
Клонировать / скачать репозиторий
Вы можете использовать composer
composer require phalcon/zephir:dev-master
Затем переместить проект выполните следующую команду
vendor/bin/zephir generate
-
И установить путь, как показано ниже
(Переменную PATH лучше модифицировать через графический интерфейс в свойствах компютера, во избежания порчи системы.)
setx path "%path%;c:\path-to-zephir\bin"
Установка парсера Zephir
- Скачать Zephir Parser для Windows
- Извлеките файл DLL и скопируйте его в каталог расширений PHP
-
Отредактируйте
php.ini
и добавьте эту строку:
[Zephir Parser] ; You can use here absolute path to your custom modules dir ; or relative to the PHP modules dir extension=zephir_parser.dll
Примечание: также вы можете скомпилировать его самостоятельно.
Использование Zephir
- [PHP7 или позже] Открыть командную строку Visual Studio 2015 (искать по cmd или просто открыть
"%VS140COMNTOOLS%\VsDevCmd"
) - [PHP5.5 или позже] Открыть командную строку Visual Studio 2012 (искать по cmd или просто открыть
"%VS110COMNTOOLS%\VsDevCmd"
) - Выполнить
%PHP_SDK%\bin\phpsdk_setvars
CD
для вашего расширения иzephir build
- Возьмите построенный
.dll
изyour_ext/Release/php_extname.dll
(илиyour_ext/Release_TS/php_extname.dll
)
Дополнительные ссылки
- Создание PHP 5.5 - 7.1 под Windows: https://wiki.php.net/internals/windows/stepbystepbuild
- Создание PHP 7.2+ под Windows: https://wiki.php.net/internals/windows/stepbystepbuild_sdk_2