Initial Commit
This commit is contained in:
Riley Schneider
52
database/php/docs/PEAR/INSTALL
Normal file
52
database/php/docs/PEAR/INSTALL
Normal file
@@ -0,0 +1,52 @@
|
||||
PEAR - The PEAR Installer
|
||||
=========================
|
||||
Installing the PEAR Installer.
|
||||
|
||||
You should install PEAR on a local development machine first. Installing
|
||||
PEAR on a remote production machine should only be done after you are
|
||||
familiar with PEAR and have tested code using PEAR on your development
|
||||
machine.
|
||||
|
||||
There are two methods of installing PEAR
|
||||
- PEAR bundled in PHP
|
||||
- go-pear
|
||||
|
||||
We will first examine how to install PEAR that is bundled with PHP.
|
||||
|
||||
Microsoft Windows
|
||||
=================
|
||||
If you are running PHP 5.2.0 or newer, simply download and
|
||||
run the windows installer (.msi) and PEAR can be automatically
|
||||
installed.
|
||||
|
||||
Otherwise, for older PHP versions, download the .zip of windows,
|
||||
there is a script included with your PHP distribution that is called
|
||||
"go-pear". You must open a command box in order to run it. Click
|
||||
"start" then click "Run..." and type "cmd.exe" to open a command box.
|
||||
Use "cd" to change directory to the location of PHP where you unzipped it,
|
||||
and run the go-pear command.
|
||||
|
||||
Unix
|
||||
====
|
||||
When compiling PHP from source, you simply need to include the
|
||||
--with-pear directive on the "./configure" command. This is "on"
|
||||
by default in most PHP versions, but it doesn't hurt to list it
|
||||
explicitly. You should also consider enabling the zlib extension via
|
||||
--enable-zlib, so that the PEAR installer will be able to handle gzipped
|
||||
files (i.e. smaller package files for faster downloads). Later, when you
|
||||
run "make install" to install PHP itself, part of the process will be
|
||||
prompts that ask you where you want PEAR to be installed.
|
||||
|
||||
go-pear
|
||||
=======
|
||||
For users who cannot perform the above steps, or who wish to obtain the
|
||||
latest PEAR with a slightly higher risk of failure, use go-pear. go-pear
|
||||
is obtained by downloading http://pear.php.net/go-pear and saving it as go-pear.php.
|
||||
After downloading, simply run "php go-pear.php" or open it in a web browser
|
||||
(windows only) to download and install PEAR.
|
||||
|
||||
You can always ask general installation questions on pear-general@lists.php.net,
|
||||
a public mailing list devoted to support for PEAR packages and installation-
|
||||
related issues.
|
||||
|
||||
Happy PHPing, we hope PEAR will be a great tool for your development work!
|
||||
27
database/php/docs/PEAR/LICENSE
Normal file
27
database/php/docs/PEAR/LICENSE
Normal file
@@ -0,0 +1,27 @@
|
||||
Copyright (c) 1997-2009,
|
||||
Stig Bakken <ssb@php.net>,
|
||||
Gregory Beaver <cellog@php.net>,
|
||||
Helgi Þormar Þorbjörnsson <helgi@php.net>,
|
||||
Tomas V.V.Cox <cox@idecnet.com>,
|
||||
Martin Jansen <mj@php.net>.
|
||||
All rights reserved.
|
||||
|
||||
Redistribution and use in source and binary forms, with or without
|
||||
modification, are permitted provided that the following conditions are met:
|
||||
|
||||
* Redistributions of source code must retain the above copyright notice,
|
||||
this list of conditions and the following disclaimer.
|
||||
* Redistributions in binary form must reproduce the above copyright
|
||||
notice, this list of conditions and the following disclaimer in the
|
||||
documentation and/or other materials provided with the distribution.
|
||||
|
||||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
|
||||
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||||
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
||||
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||||
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
88
database/php/docs/PEAR/README.rst
Normal file
88
database/php/docs/PEAR/README.rst
Normal file
@@ -0,0 +1,88 @@
|
||||
*************************
|
||||
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::
|
||||
|
||||
$ rm -f PEAR-*.tgz
|
||||
$ pear package package2.xml
|
||||
$ cd go-pear-tarballs
|
||||
$ rm -f PEAR-*
|
||||
$ cp ../PEAR-*.tgz .
|
||||
$ gunzip PEAR-*.tgz
|
||||
$ pear download -Z Archive_Tar Console_Getopt Structures_Graph XML_Util
|
||||
$ mkdir src && cd src
|
||||
$ for i in ../*.tar; do tar xvf $i; done
|
||||
$ mv *\/* .
|
||||
$ cd ../../
|
||||
$ php make-gopear-phar.php
|
||||
$ php make-installpear-nozlib-phar.php
|
||||
|
||||
(Or simply run ``build-release.sh``).
|
||||
|
||||
``go-pear.phar`` is contains the PEAR installer installer that asks questions
|
||||
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.
|
||||
Reference in New Issue
Block a user