个人工具

“UbuntuHelp:PhpPear”的版本间的差异

来自Ubuntu中文

跳转至: 导航, 搜索
(新页面: {{From|https://help.ubuntu.com/community/PhpPear}} {{Languages|UbuntuHelp:PhpPear}} == PHP PEAR Introduction == PHP PEAR is a PHP Extension and Application Repository == Modules == PHP...)
 
第4行: 第4行:
  
 
== PHP PEAR Introduction ==
 
== PHP PEAR Introduction ==
PHP PEAR is a PHP Extension and Application Repository
+
PHP PEAR is a PHP Extension and Application Repository.  PEAR is somewhat similar to Perl's [http://www.cpan.org/ CPAN] and Ruby's [http://www.rubygems.org/ RubyGems]. PEAR functions like a Package Manager for PHP code and a whole lot more.
  
== Modules ==
+
 
PHP PEAR modules
+
== Installation ==
 +
 
 +
Install the '''php-pear''' package using your favorite Ubuntu package manager.
 +
 
 +
See InstallingSoftware for different ways to install the php-pear package.
 +
 
 +
 
 +
== Using PEAR ==
 +
 
 +
This section discusses some of the common uses of PEAR. For more detailed instructions on using PEAR see the [http://pear.php.net/manual PEAR Manual]
 +
 
 +
* Get a list of software available using PEAR
 
<pre><nowiki>
 
<pre><nowiki>
$ aptitude search php | grep -i pear
+
pear remote-list
p  dh-make-php                    - Creating debian source packages for pear a
+
</nowiki></pre>
p  php-auth                        - PHP PEAR modules for creating an authentic
+
p  php-date                        - PHP PEAR module for Date and Time Zone Cla
+
p  php-db                          - PHP PEAR Database Abstraction Layer
+
p  php-file                        - PHP Pear modules for common file and direc
+
p  php-html-template-it            - PEAR HTML Template IT
+
p  php-http                        - PHP PEAR module for HTTP related stuff
+
p  php-image-canvas                - Image_Canvas module for PEAR
+
p  php-image-graph                - Image_Graph module for PEAR
+
p  php-mail                        - PHP PEAR module for sending email
+
p  php-mail-mime                  - PHP PEAR module for creating and decoding
+
p  php-net-sieve                  - net_sieve module for PEAR
+
p  php-net-smtp                    - PHP PEAR module implementing SMTP protocol
+
p  php-net-socket                  - PHP PEAR Network Socket Interface module
+
p  php-pear                        - PEAR - PHP Extension and Application Repos
+
p  php-xml-parser                  - PHP PEAR module for parsing XML
+
p  php4-pear                      - PHP Extension and Application Repository (
+
p  php4-pear-log                  - Log module for PEAR
+
  
 +
* Install a package
 +
<pre><nowiki>
 +
pear install <package_name>
 
</nowiki></pre>
 
</nowiki></pre>
  
== Installation ==
+
* List packages installed
Install
+
 
<pre><nowiki>
 
<pre><nowiki>
$ aptitude install php-pear
+
pear list
 
</nowiki></pre>
 
</nowiki></pre>
and any optional PHP PEAR modules such as
+
 
 +
* List files belonging to an installed package
 
<pre><nowiki>
 
<pre><nowiki>
$ aptitude install php-db
+
pear list-files <package_name>
$ aptitude install php-image-graph
+
</nowiki></pre>
 +
 
 +
* Uninstall a PEAR package
 +
<pre><nowiki>
 +
pear uninstall <package_name>
 +
</nowiki></pre>
 +
 
 +
 
 +
== Example ==
 +
In this example the we'll install the [http://pear.php.net/package/System_Folders System_Folders] package.  System_Folders provides methods to get the locations of various system folders like home directory, desktop folder and "My documents".
 +
 
 +
* Install System_Folders
 +
<pre><nowiki>
 +
command:
 +
sudo pear install System_Folders
 +
 
 +
output:
 +
Did not download optional dependencies: pear/XML_Parser, pear/XML_Util, use --alldeps to download automatically
 +
pear/Config can optionally use package "pear/XML_Parser"
 +
pear/Config can optionally use package "pear/XML_Util"
 +
downloading System_Folders-1.0.0.tgz ...
 +
Starting to download System_Folders-1.0.0.tgz (8,364 bytes)
 +
.....done: 8,364 bytes
 +
downloading Config-1.10.11.tgz ...
 +
Starting to download Config-1.10.11.tgz (27,718 bytes)
 +
...done: 27,718 bytes
 +
install ok: channel://pear.php.net/Config-1.10.11
 +
install ok: channel://pear.php.net/System_Folders-1.0.0
 +
</nowiki></pre>
 +
Notice PEAR mentions some optional packages to install.
 +
 
 +
* Double check that System_Folders is installed
 +
<pre><nowiki>
 +
command:
 +
pear list
 +
 
 +
output:
 +
Package            Version  State
 +
System_Folders    1.0.0    stable
 +
</nowiki></pre>
 +
'''Note:''' You'll probably have other PEAR packages in the list.  Some are installed when you install PHP.
 +
 
 +
* List the files that System_Folders installed
 +
<pre><nowiki>
 +
command:
 +
pear list-files System_Folders
 +
 
 +
output:
 +
Installed Files For System_Folders
 +
==================================
 +
Type Install Path
 +
php  /usr/share/php/System/Folders/Cached.php
 +
doc  /usr/share/php/docs/System_Folders/examples/cached.php
 +
doc  /usr/share/php/docs/System_Folders/examples/example.php
 +
php  /usr/share/php/System/Folders.php
 +
</nowiki></pre>
 +
'''Note:''' The path names may vary depending on your system.
 +
 
 +
* Using System_Folders in a PHP program.
 +
** We'll create a simple PHP script to print the location of your Home folder.
 +
** Open your favorite text editor and add the following:
 +
<pre><nowiki>
 +
<?php
 +
 
 +
require_once 'System/Folders.php';
 +
$sf = new System_Folders();
 +
$home = $sf->getHome();
 +
echo "$home\n";
 +
 
 +
?>
 +
</nowiki></pre>
 +
** Save the file as system_folders_test.php (or simply test.php if you're into the whole brevity thing).
 +
** Next execute the script:
 +
<pre><nowiki>
 +
php system_folders_test.php
 +
</nowiki></pre>
 +
** If all went well you should see the path to your Home directory printed to the console.
 +
'''Note:''' to execute the above command you'll need to have '''php-cli''' installed on your system.
 +
** If you have Apache or another web server configured to use PHP you could also place the file somewhere in your DocumentRoot and point your browser to it.
 +
*** For example: <code><nowiki>http://localhost/test/system_folders_test.php</nowiki></code>
 +
 
 +
* If after all that you've decided that System_Folders isn't all that useful you can uninstall it by:
 +
<pre><nowiki>
 +
command:
 +
sudo pear uninstall System_Folders
 +
 
 +
output:
 +
uninstall ok: channel://pear.php.net/System_Folders-1.0.0
 
</nowiki></pre>
 
</nowiki></pre>
  
 
== NOTES ==
 
== NOTES ==
 
1)
 
1)
Some PHP PEAR modules seem to be missing from Ubuntu and you will have to manually install them by using PEAR
+
Some PHP PEAR modules are packaged for installation using Ubuntu package managers, but if the package you're looking for is missing from Ubuntu and you will have to manually install them by using PEAR.  See above for instructions.
  
 +
For example:
 
<pre><nowiki>
 
<pre><nowiki>
$ pear install Image_color
+
pear install Image_color
$ pear install Image_Text
+
pear install Image_Text
$ pear install channel://pear.php.net/Image_Text-0.5.2beta2
+
pear install channel://pear.php.net/Image_Text-0.5.2beta2
 
</nowiki></pre>
 
</nowiki></pre>
 +
  
 
2)
 
2)
第65行: 第151行:
 
$
 
$
 
</nowiki></pre>
 
</nowiki></pre>
 +
 +
 +
'''Note:''' This guide has been tested on Ubuntu 6.06 (Dapper), Ubuntu 7.10 (Gutsy).
 
----
 
----
 
[[category:CategoryDocumentation]]
 
[[category:CategoryDocumentation]]

2007年11月21日 (三) 18:20的版本


PHP PEAR Introduction

PHP PEAR is a PHP Extension and Application Repository. PEAR is somewhat similar to Perl's CPAN and Ruby's RubyGems. PEAR functions like a Package Manager for PHP code and a whole lot more.


Installation

Install the php-pear package using your favorite Ubuntu package manager.

See InstallingSoftware for different ways to install the php-pear package.


Using PEAR

This section discusses some of the common uses of PEAR. For more detailed instructions on using PEAR see the PEAR Manual

  • Get a list of software available using PEAR
pear remote-list
  • Install a package
pear install <package_name>
  • List packages installed
pear list
  • List files belonging to an installed package
pear list-files <package_name>
  • Uninstall a PEAR package
pear uninstall <package_name>


Example

In this example the we'll install the System_Folders package. System_Folders provides methods to get the locations of various system folders like home directory, desktop folder and "My documents".

  • Install System_Folders
command:
sudo pear install System_Folders

output:
Did not download optional dependencies: pear/XML_Parser, pear/XML_Util, use --alldeps to download automatically
pear/Config can optionally use package "pear/XML_Parser"
pear/Config can optionally use package "pear/XML_Util"
downloading System_Folders-1.0.0.tgz ...
Starting to download System_Folders-1.0.0.tgz (8,364 bytes)
.....done: 8,364 bytes
downloading Config-1.10.11.tgz ...
Starting to download Config-1.10.11.tgz (27,718 bytes)
...done: 27,718 bytes
install ok: channel://pear.php.net/Config-1.10.11
install ok: channel://pear.php.net/System_Folders-1.0.0

Notice PEAR mentions some optional packages to install.

  • Double check that System_Folders is installed
command:
pear list 

output:
Package            Version   State
System_Folders     1.0.0     stable

Note: You'll probably have other PEAR packages in the list. Some are installed when you install PHP.

  • List the files that System_Folders installed
command:
pear list-files System_Folders

output:
Installed Files For System_Folders
==================================
Type Install Path
php  /usr/share/php/System/Folders/Cached.php
doc  /usr/share/php/docs/System_Folders/examples/cached.php
doc  /usr/share/php/docs/System_Folders/examples/example.php
php  /usr/share/php/System/Folders.php

Note: The path names may vary depending on your system.

  • Using System_Folders in a PHP program.
    • We'll create a simple PHP script to print the location of your Home folder.
    • Open your favorite text editor and add the following:
<?php

require_once 'System/Folders.php';
$sf = new System_Folders();
$home = $sf->getHome();
echo "$home\n";

?>
    • Save the file as system_folders_test.php (or simply test.php if you're into the whole brevity thing).
    • Next execute the script:
php system_folders_test.php
    • If all went well you should see the path to your Home directory printed to the console.

Note: to execute the above command you'll need to have php-cli installed on your system.

    • If you have Apache or another web server configured to use PHP you could also place the file somewhere in your DocumentRoot and point your browser to it.
      • For example: http://localhost/test/system_folders_test.php
  • If after all that you've decided that System_Folders isn't all that useful you can uninstall it by:
command:
sudo pear uninstall System_Folders

output:
uninstall ok: channel://pear.php.net/System_Folders-1.0.0

NOTES

1) Some PHP PEAR modules are packaged for installation using Ubuntu package managers, but if the package you're looking for is missing from Ubuntu and you will have to manually install them by using PEAR. See above for instructions.

For example:

pear install Image_color
pear install Image_Text
pear install channel://pear.php.net/Image_Text-0.5.2beta2


2) If you are trying to use Image_graph you may get

Warning: imagettfbbox() [function.imagettfbbox]:
Could not find/open font in /mnt/sites/asmtennis.net/web/PEAR/Image/Canvas/GD.php

unless you have installed TrueType fonts and created a symbolic link to them

$ sudo -i
# cd /usr/share/php/Image/Canvas
# ln -s /usr/share/fonts/truetype/msttcorefonts/ Fonts
$


Note: This guide has been tested on Ubuntu 6.06 (Dapper), Ubuntu 7.10 (Gutsy).