How do I use and install PEAR packages?
PEAR packages are files that contain prewritten PHP code. Some scripts use PEAR packages to perform tasks such as connecting to a database.
Our Web hosting service supports PEAR, and we have the following "stable" packages installed:
Archive_Tar HTML_Template_IT Net_LMTP Auth HTTP Net_NNTP Auth_SASL HTTP_Client Net_POP3 Benchmark HTTP_Request Net_Ping Cache HTTP_Request2 Net_Portscan Cache_Lite Log Net_SMTP Console_Getopt MDB2 Net_Sieve Crypt_CBC MDB2_Driver_mysql Net_SmartIRC Crypt_CHAP Mail Net_Socket Crypt_HMAC Mail_Mime Net_URL Crypt_RC4 Math_Integer Net_URL2 DB Net_CheckIP Net_UserAgent_Detect DB_NestedSet Net_Curl Net_Whois Date Net_DNS Numbers_Roman File Net_DNSBL PEAR File_CSV Net_Dict Pager File_Find Net_Dig Structures_Graph File_Passwd Net_FTP Text_Password File_SearchReplace Net_Finger XML_Parser File_Util Net_Geo XML_RPC HTML_Common Net_IMAP XML_Serializer HTML_Form Net_IPv4 XML_Util HTML_QuickForm Net_IPv6 HTML_Table Net_Ident
Installing other PEAR packages
If you want to install a PEAR package that is not "stable" (that is, a package marked "alpha" or "beta" on the PEAR website), you can do so by creating your own PEAR directory.
To do this, you should be comfortable with the command line. Just make a command line connection, then type the following two lines after logging in (you can copy and paste them from here):
pear config-create ~ .pearrc pear install -o PEAR
This creates a custom PEAR directory located in your home directory.
You can then install your own PEAR modules at any time by typing this:
pear install --alldeps PACKAGE
... where "
PACKAGE" is the name of the package, followed by "
-alpha" or "
For example, to install the beta version of the
Spreadsheet_Excel_Writer package, you would type:
pear install --alldeps Spreadsheet_Excel_Writer-beta
Using custom PEAR packages you install
Once you've installed a package, you'll need to tell your PHP script where to find it. Enter your domain name in the box at the top of this page to see how to do this.
What if I have more questions about PEAR?
The instructions above are based on the PEAR documentation, which has more details and resources for answering questions. You should read the PEAR documentation if you have further questions about PEAR.