3 [![Join the chat at https://gitter.im/pharext/pharext](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/pharext/pharext?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
5 Distribute your PHP extension as self-installable phar executable. See https://pharext.org
9 You don't need this package to install any `*.ext.phar` extension packages,
10 just run them with php:
12 $ ./pecl_http-2.4.2.ext.phar
14 For a compressed phar, or if the execute permission bit got lost somehow:
16 $ php pecl_http-2.4.2.ext.phar.gz
20 $ ./pecl_http-2.4.2.ext.phar -h
24 pharext v3.0.0 (c) Michael Wallner <mike@php.net>
28 $ ./pecl_http-2.4.2.ext.phar [-hvqs] [-p|-n|-c|-i <arg>]
30 -h|--help Display help
31 -v|--verbose More output
32 -q|--quiet Less output
33 -p|--prefix <arg> PHP installation prefix if phpize is not in $PATH, e.g. /opt/php7
34 -n|--common-name <arg> PHP common program name, e.g. php5 or zts-php [php]
35 -c|--configure <arg> Additional extension configure flags, e.g. -c --with-flag
36 -s|--sudo [<arg>] Installation might need increased privileges [sudo -S %s]
37 -i|--ini <arg> Activate in this php.ini instead of loaded default php.ini
38 --signature Show package signature
39 --license Show package license
40 --name Show package name
41 --date Show package release date
42 --release Show package release version
43 --version Show pharext version
44 --enable-propro [<arg>] Whether to enable property proxy support [yes]
45 --enable-raphf [<arg>] Whether to enable raphf support [yes]
46 --with-http-zlib-dir [<arg>] Where to find zlib [/usr]
47 --with-http-libcurl-dir [<arg>] Where to find libcurl [/usr]
48 --with-http-libevent-dir [<arg>] Where to find libevent [/usr]
51 If your installation destination needs escalated permissions, have a look at [the `--sudo` option](https://github.com/m6w6/pharext/wiki/Usage-of-*.ext.phar-packages#privileges):
53 Installing propro-1.0.1.ext.phar ...
57 Running make install ...
58 Running INI activation ...
59 Extension already activated ...
60 Successfully installed propro-1.0.1.ext.phar!
61 Installing raphf-1.0.5.ext.phar ...
65 Running make install ...
66 Running INI activation ...
67 Extension already activated ...
68 Successfully installed raphf-1.0.5.ext.phar!
69 Installing pecl_http-2.4.2.ext.phar ...
73 Running make install ...
74 Running INI activation ...
75 Extension already activated ...
76 Successfully installed pecl_http-2.4.2.ext.phar!
81 The usual tools you need to build a PHP extension:
82 * php, phpize and php-config
83 * make, cc and autotools
85 A network connection is not needed.
87 ## Extension maintainers
89 Download the pharext binary of the [latest release](https://github.com/pharext/pharext/releases/latest).
91 Be aware that you need the [public key](https://github.com/pharext/pharext/wiki/Public-key) to run official `pharext` releases.
93 -----BEGIN PUBLIC KEY-----
94 MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA5x9bwisjDBDV/bwDiju2
95 Ebx4kPir32WwT3+hxV0/qAPclA1WsrpcUJ7BChk+Rlz8ujOcyENTidgI1vj3oUpo
96 /P9XlLQOSrJHYz+AOg7qwhTe89xIJspS4gHHiXUAmxz0TyCNMbOyrLcjP5CmZdll
97 n+e3HP8Kfipr4XyWBhsKbdYUZ8Ga6IeFMYzNqCzWazcOasdCpsablmyrfCaZoJ0l
98 bFald0nF3/YoeYgo3fWb4Md9Xf/grpz8Ocqyq4OY49Vb0/p8FMwzBV6vbVh/eAV/
99 jrP7L40Jw97nSBrP/5nK8Ylc5BayVRq/HhT3kLMC//zvPjb8xz3ZgVTQrwWTF3Zy
101 -----END PUBLIC KEY-----
103 Place it as `pharext.pubkey` in the same directory where the `pharext` binary is located. IF you cloned the repository or installed `pharext` through composer, it is already at the right location.
105 Please have a look at the [wiki](https://github.com/pharext/pharext/wiki), to learn [how to use](https://github.com/pharext/pharext/wiki/Usage-of-the-pharext-packager) the pharext installer to package self-installing PHP extensions.