以下是原文翻译成繁體中文（zh-tw）的Markdown格式内容：

PHP - PEAR

# PHP - PEAR：初學者的全面指南

## PEAR 的介紹

你好，有志於PHP開發的各位！今天，我們將要深入探索PEAR的世界，這是一個讓你的PHP編程之旅更加順利的神奇工具。作為你友善的鄰居計算機老師，我很興奮能指導你走過這次冒險。我們從基礎開始！

### PEAR 是什麼？

PEAR 的全稱是 PHP Extension and Application Repository，把它當成一個裝滿了現成的PHP組件的寶藏 chest 吧。這就像擁有一個神奇的工具箱，可以幫助你建造令人驚艷的網絡應用程序，而不需要每次都重新發明輪子。

## 開始使用 PEAR

### 安裝 PEAR

在我們可以使用PEAR之前，我們需要先安裝它。別擔心；這比你想像的要容易！

1. 對於Windows用戶：
   - 從PEAR官方網站下載 go-pear.phar 文件。
   - 打開你的命令提示符，並導航到下載文件的文件夾。
   - 執行以下命令：

php go-pear.phar


2. 對於Mac和Linux用戶：
   - 打開你的終端並運行：

curl -O https://pear.php.net/go-pear.phar php go-pear.phar


按照安裝提示操作，然後，你就安裝好了PEAR。

## 使用 PEAR 套件

現在，我們已經安裝了PEAR，來看看如何使用它的套件。這就像打開那個神奇的工具箱，並挑選出完美的工具來完成工作！

### 安裝一個 PEAR 套件

讓我們安裝一個叫做 `HTML_QuickForm` 的流行PEAR套件，它幫助創建和驗證HTML表單。

pear install HTML_QuickForm


### 使用 HTML_QuickForm 創建一個簡單表單

現在，讓我們使用我們剛剛安裝的套件來創建一個簡單的註冊表單。以下是一個示例：

```php
<?php
require_once 'HTML/QuickForm.php';

$form = new HTML_QuickForm('registration', 'post');

$form->addElement('text', 'username', '用戶名:');
$form->addElement('password', 'password', '密碼:');
$form->addElement('submit', null, '註冊');

if ($form->validate()) {
    echo '<h2>感謝您註冊！</h2>';
    echo '用戶名: ' . $form->getElement('username')->getValue() . '<br>';
    echo '密碼: ' . str_repeat('*', strlen($form->getElement('password')->getValue()));
} else {
    $form->display();
}
?>

讓我們分解一下：

我們包含 HTML_QuickForm 套件。
我們創建一個新的表單對象。
我們添加表單元素：一個用戶名的文本字段，一個密碼字段，以及一個提交按鈕。
我們檢查表單是否已提交並有效。
如果有效，我們顯示一條感謝信息以及輸入的用戶名（並用星號替換密碼）。
如果無效或未提交，我們顯示表單。

PEAR 套件管理

PEAR 伴隨一個方便的套件管理器。讓我們看看一些常用的命令：

命令	描述
`pear list`	列出已安裝的套件
`pear search <關鍵詞>`	搜索套件
`pear install <套件>`	安裝一個套件
`pear upgrade <套件>`	升級一個套件
`pear uninstall <套件>`	卸載一個套件

創建你自己的 PEAR 套件

想要嘗試一下冒險嗎？讓我們創建一個簡單的PEAR套件！我們將創建一個基本的計算器類。

創建一個名為 Calculator.php 的文件：

<?php
class Calculator
{
    public function add($a, $b) {
        return $a + $b;
    }

    public function subtract($a, $b) {
        return $a - $b;
    }

    public function multiply($a, $b) {
        return $a * $b;
    }

    public function divide($a, $b) {
        if ($b == 0) {
            throw new Exception("除以零！");
        }
        return $a / $b;
    }
}
?>

創建一個 package.xml 文件：

<?xml version="1.0" encoding="UTF-8"?>
<package version="2.0" xmlns="http://pear.php.net/dtd/package-2.0">
 <name>Calculator</name>
 <channel>pear.php.net</channel>
 <summary>簡單計算器類</summary>
 <description>一個具有加、減、乘、除功能的基礎計算器類。</description>
 <lead>
  <name>你的名字</name>
  <user>你的用戶名</user>
  <email>你的電子郵件地址</email>
  <active>是</active>
 </lead>
 <date>2023-06-15</date>
 <version>
  <release>1.0.0</release>
  <api>1.0.0</api>
 </version>
 <stability>
  <release>穩定</release>
  <api>穩定</api>
 </stability>
 <license uri="http://www.php.net/license">PHP 授權</license>
 <notes>初始發布</notes>
 <contents>
  <dir name="/">
   <file name="Calculator.php" role="php" />
  </dir>
 </contents>
 <dependencies>
  <required>
   <php>
    <min>5.0.0</min>
   </php>
   <pearinstaller>
    <min>1.4.0</min>
   </pearinstaller>
  </required>
 </dependencies>
 <phprelease />
</package>

組裝你的類：

pear package

恭喜你！你剛剛創建了你的第一個PEAR套件。

結論

我們已經從安裝到創建我們自己的套件，闡述了PEAR的基本知識。記住，PEAR對於PHP開發者來說就像瑞士軍刀一樣 - 几乎每個工作都有適合的工具。在你繼續你的PHP冒險時，你會發現PEAR是一個無價的伴侶。

繼續探索，繼續編程，最重要的是，玩得開心！誰知道呢？也許下一個大型的PEAR套件會由你創建！

Credits: Image by storyset