XOOPS輕鬆架 - 線上書籍

:::

PHP8入門
======

### 一、使用PHP元件

1. 請站在巨人的肩膀上，別重複造輪子
2. <https://packagist.org> 有大量人家做好的PHP元件可用！
3. 欲使用 Packagist 的元件，請使用 Composer 來安裝。
4. 沒裝 Composer 其實也不會怎樣，不影響開發，只是找元件就必須手動處理。
 
### 二、安裝 Composer

1. Composer 中文網頁：<https://getcomposer.ycnets.com/>
2. 至 <https://getcomposer.org/download>/ 下載 Composer（或[直接按這裡下載Windows版](https://getcomposer.org/Composer-Setup.exe)）
3. 安裝過程中，<u>**不需要**</u>去勾選任何東西。
4. 需先安裝好AMP環境，因為安裝時，要選擇 php.exe 的位置。（會自動吃環境變數的設定）  
     ![](https://campus-xoops.tn.edu.tw/uploads/tad_book3/image/52/Composer-Setup.tmp_JPm1kqhohm.png)
5. 第一次裝完 Composer 可能要登出再登入才會生效（若PHP環境變數沒自動抓到的話）
6. 裝好後的位置在 C:\\Users\\帳號\\AppData\\Roaming\\Composer
7. 請開啟終端機（開始→附屬應用程式→Windows PowerShell→Windows PowerShell），測試是否OK： 
    ```bash
    composer diagnose
    ```
8. 日後如果在composer.json有安裝新套件，可執行以下語法以安裝新套件 
    ```bash
    composer update
    ```
 
### 三、各種問題排除

1. 若是執行時出現「<span style="color:#FF0000;">composer : 無法辨識 'composer' 詞彙是否為 Cmdlet、函數、指令檔或可執行程式的名稱。請檢查名稱拼字是否正確，如果包含路徑的話，請確認路徑是否正確，然後再試一次。</span>」那影在環境變數中加入以下兩個路徑即可（其中`%USERPROFILE%`就是使用者家目錄，如：C:\\Users\\帳號）：
    
     
    ```ini
    %USERPROFILE%\AppData\Local\ComposerSetup\bin
    %USERPROFILE%\AppData\Roaming\Composer\vendor\bin
    ```
2. 如果有key設定失敗的問題，請執行以下指令，並連結到 <https://composer.github.io/pubkeys.html> 依據指示貼入金鑰設定值即可：
    
     
    ```bash
    composer self-update --update-keys
    ```
3. 日後要更新 Composer（或太久沒用）： 
    ```bash
    composer self-update
    ```
4. 如果更新時出現下面訊息，表示composer太舊，那就請移除composer，並安裝 > 1.73 版的composer
    
     
    ```bash
      [RuntimeException]
      SHA384 is not supported by your openssl extension, could not verify the phar file integrity
    ```
5. 如果安裝過程中有報錯，例如出現以下訊息： 
    ```bash
    Failed to decode response: zlib_decode(): data error
    ```
    
    那麼可以試試執行清除快取的指令，有時候就可以解決了。
    
     
    ```bash
    composer clear-cache
    ```
 
### 四、用 Composer 安裝 Packagist 的元件

1. 直接下指令即可，例如（全局安裝才需要global，會安裝至C:\\Users\\帳號\\AppData\\Roaming\\Composer下，而非專案下）： 
    ```bash
    composer global require hirak/prestissimo
    ```
2. 如此，Composer 便會自動判斷每個元件的最穩定版本編號，並下載該元件，以及更新相關元件。
3. hirak/prestissimo 是一個可以加快composer安裝速度的套件，可以讓 composer 也能多進程並行下載。
4. 若要查詢某套件的詳情或版本：
    
     
    ```bash
    composer show 套件名稱
    ```
5. 若要解除已安裝套件
    
     
    ```bash
    composer remove 套件名稱
    ```
6. 詳細指令請參考：<https://getcomposer.ycnets.com/doc/03-cli.md>

:::