git.m6w6.name Git - pharext/pharext/blob - README.md

   1 # pharext
   2
   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)
   4
   5 Distribute your PHP extension as self-installable phar executable. See https://pharext.org
   6
   7 ## About
   8
   9 You don't need this package to install any `*.ext.phar` extension packages,
  10 just run them with php:
  11
  12         $ ./pecl_http-2.4.2.ext.phar
  13
  14 For a compressed phar, or if the execute permission bit got lost somehow:
  15
  16         $ php pecl_http-2.4.2.ext.phar.gz
  17
  18 Command help:
  19
  20         $ ./pecl_http-2.4.2.ext.phar -h
  21
  22 Yields:
  23
  24         pharext v3.0.0 (c) Michael Wallner <mike@php.net>
  25
  26         Usage:
  27
  28         $ ./pecl_http-2.4.2.ext.phar [-hvqs] [-p|-n|-c|-i <arg>]
  29
  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]
  49
  50
  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):
  52
  53         Installing propro-1.0.1.ext.phar ...
  54         Running phpize ...
  55         Running configure ...
  56         Running make ...
  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 ...
  62         Running phpize ...
  63         Running configure ...
  64         Running make ...
  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 ...
  70         Running phpize ...
  71         Running configure ...
  72         Running make ...
  73         Running make install ...
  74         Running INI activation ...
  75         Extension already activated ...
  76         Successfully installed pecl_http-2.4.2.ext.phar!
  77
  78
  79 ### Prerequisites
  80
  81 The usual tools you need to build a PHP extension:
  82 * php, phpize and php-config
  83 * make, cc and autotools
  84
  85 A network connection is not needed.
  86
  87 ## Extension maintainers
  88
  89 Download the pharext binary of the [latest release](https://github.com/pharext/pharext/releases/latest).
  90
  91 Be aware that you need the [public key](https://github.com/pharext/pharext/wiki/Public-key) to run official `pharext` releases.
  92
  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
 100         +wIDAQAB
 101         -----END PUBLIC KEY-----
 102
 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.
 104
 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.
 106