PHPCon Poland 2024

Компиляция разделяемых модулей с помощью phpize

Иногда не получается использовать инсталлятор pecl. Этому может мешать брандмауэр или устанавливаемый модуль недоступен в качестве PECL-совместимого пакета, например, модули из системы управления версиями (git), у которых ещё не было выпусков. Такой модуль можно собрать вручную, используя низкоуровневые утилиты сборки.

Команду phpize выполняют для подготовки окружения PHP-модуля. В следующем примере исходные коды для модуля лежат в директории с названием extname:

$ cd extname
$ phpize
$ ./configure
$ make
# make install

При успешной установке будет создан файл, а затем помещён в директорию модулей PHP. Модуль можно будет использовать после корректировки файла php.ini — в него необходимо будет добавить строку

Если в системе нет команды phpize, но доступна работа с предустановленными пакетами (наподобие RPM), необходимо убедиться, что также установлена соответствующая версия пакета PHP для разработчиков, так как они часто содержат команду phpize с правильными файлами заголовков для сборки PHP и его модулей.

Для дополнительной информации выполните команду phpize --help.

add a note

User Contributed Notes 5 notes

16 years ago
If you have multiple PHP versions installed, you may be able to specify for which installation you'd like to build by using the --with-php-config option during configuration.

--with-php-config=[Insert path to proper php-config here]

For example (my case):
./configure --with-php-config=/usr/local/php5/bin/php-config5
admin at eexit dot net
11 years ago
When compiling an extension for a stack which is 64 bits (for example) and your compiler is configured to compile in 32 bits, you can manually compile your extensions using C flags before your configure.

Example: my system compiler is 32 bits and my stack is 64 bits. To compile my xdebug:

# phpize
# CFLAGS=-m64 CPPFLAGS=-m64 CCASFLAGS=-m64 ./configure --enable-xdebug
# gmake
# file modules/
modules/ ELF 64-bit LSB dynamic lib AMD64 Version 1, dynamically linked, not stripped, no debugging information available
dmytton at php dot net
18 years ago
In some situations (e.g. on a cPanel server), the built extension will not be placed into the correct extensions directory by the make install process. Use your phpinfo() output to determine what the correct extension_dir path is and move the generated .so file into that directory. The line in php.ini will then find the extension file correctly.
17 years ago
When you have multiple installations of PHP, running phpize from a specific installation will not force the module to be compiled with that installation's include files.

In my case, I had a standard PHP distribution installed, and am evaluating Zend Core / Zend Platform, which installed it's own Apache & PHP in a /usr/local/Zend/.. install path. It was missing the module, so I had to compile my own.

Running Zend Core's phpize, the output indicates that configuration for that module will occur. But when running ./configure, the standard installation's include files are used. The result being compiled against the wrong PHP would not load when Zend Core's php initializes.

The only way I could see to correct the situation was to temporarily change the standard PHP include path to point to the Zend Core's include files. In my case, I made a backup copy of /usr/include/php5 and did a "ln -s /usr/local/Zend/Core/include/php/ /usr/include/php5".
gautama dot himawan at yahoo dot com
9 years ago
If you failed to run phpize command, then you should install php-devel package. Command line to install the php-devel package using yum is: yum install php-devel.

If you failed to compile the PECL extension, then you should install gcc package. Command line to install the gcc package using yum is: yum install gcc.
To Top