72 lines
2.2 KiB
ReStructuredText
72 lines
2.2 KiB
ReStructuredText
*************************
|
|
PEAR - The PEAR Installer
|
|
*************************
|
|
.. image:: https://travis-ci.org/pear/pear-core.svg?branch=stable
|
|
:target: https://travis-ci.org/pear/pear-core
|
|
|
|
=========================================
|
|
What is the PEAR Installer? What is PEAR?
|
|
=========================================
|
|
PEAR is the PHP Extension and Application Repository, found at
|
|
http://pear.php.net.
|
|
|
|
The **PEAR Installer** is this software, which contains executable
|
|
files and PHP code that is used to **download and install** PEAR code
|
|
from pear.php.net.
|
|
|
|
PEAR contains useful **software libraries and applications** such as
|
|
MDB2 (database abstraction), HTML_QuickForm (HTML forms management),
|
|
PhpDocumentor (auto-documentation generator), DB_DataObject
|
|
(Data Access Abstraction), and many hundreds more.
|
|
Browse all available packages at http://pear.php.net, the list is
|
|
constantly growing and updating to reflect improvements in the PHP language.
|
|
|
|
.. warning::
|
|
Do not run PEAR without installing it - if you downloaded this
|
|
tarball manually, you MUST install it. Read the instructions in INSTALL
|
|
prior to use.
|
|
|
|
|
|
=============
|
|
Documentation
|
|
=============
|
|
Documentation for PEAR can be found at http://pear.php.net/manual/.
|
|
Installation documentation can be found in the INSTALL file included
|
|
in this tarball.
|
|
|
|
|
|
=====
|
|
Tests
|
|
=====
|
|
Run the tests without installation as follows::
|
|
|
|
$ ./scripts/pear.sh run-tests -r tests
|
|
|
|
You should have the ``Text_Diff`` package installed to get nicer error output.
|
|
|
|
To run the tests with another PHP version, modify ``php_bin`` and set the
|
|
``PHP_PEAR_PHP_BIN`` environment variable::
|
|
|
|
$ pear config-set php_bin /usr/local/bin/php7
|
|
$ PHP_PEAR_PHP_BIN=/usr/local/bin/php7 ./scripts/pear.sh run-tests -r tests
|
|
|
|
Happy PHPing, we hope PEAR will be a great tool for your development work!
|
|
|
|
|
|
Test dependencies
|
|
=================
|
|
* ``zlib``
|
|
|
|
|
|
=========
|
|
Releasing
|
|
=========
|
|
Create a PEAR package, as well as phars for pear-less installation,
|
|
simply run ``build-release.sh``).
|
|
|
|
``go-pear.phar`` contains the PEAR installer installer that asks where to install it.
|
|
It is available from http://pear.php.net/go-pear.phar.
|
|
|
|
``install-pear-nozlib.phar`` installs PEAR automatically without asking anything.
|
|
It is shipped with PHP itself.
|