File: /volume1/@appstore/WebStation/ui/help/cht/application_webserv_php.html
<!DOCTYPE html>
<html class="img-no-display" lang="zh-TW" >
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" >
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<link href="../../../../help/help.css" type="text/css" rel="stylesheet" />
<link href="../../../../help/scrollbar/flexcroll.css" type="text/css" rel="stylesheet" />
<script type="text/javascript" src="../../../../help/scrollbar/flexcroll.js"></script>
<script type="text/javascript" src="../../../../help/scrollbar/initFlexcroll.js"></script>
</head>
<body><h1>指令碼語言設定</h1>
<p><b>指令碼語言設定</b>頁面提供網站間的進階互動。您可以新增不同的設定檔來自訂多個環境。</p>
<h2>目錄</h2>
<ul>
<li><a href="#t1">PHP</a></li>
<li><a href="#t2">Python</a></li>
</ul>
<h2 class="list_head"><a name="t1" id="t1"></a>PHP</h2>
<p>在 <b>PHP</b> 頁籤，您可以管理兩種類型的 PHP 設定檔：</p>
<ul>
<li><b>套件設定檔</b>：此類別的設定檔會於服務套件安裝後，自動建立。這些設定檔可以被編輯但無法被刪除，且只能套用到其相應的服務套件。</li>
<li><b>自訂設定檔</b>：此類別的設定檔可以被使用者新增、編輯、刪除。</li>
</ul>
<h4 class="list_head">若要新增自訂的設定檔：</h4>
<ol>
<li>按一下<b>新增</b>。</li>
<li>填入<b>設定檔名稱</b>、<b>描述</b>等欄位。</li>
<li>從 <b>PHP 版本</b>的下拉式選單中選取欲使用的 PHP 後端版本。</li>
<li>於下列頁籤為設定檔進行基本設定：<ul>
<li><a href="#s1">設定</a>：設定檔的基本設定，例如：PHP 快取、Xdebug、錯誤訊息等。</li>
<li><a href="#s2">擴充模組</a>：啟用或停用設定檔中可用的擴充模組。</li>
<li><a href="#s3">FPM 設定</a>：調整 PHP FastCGI Process Manager (FPM) 的設定。</li>
<li><a href="#s4">核心設定</a>：進行設定檔 php.ini 指令的設定。</li>
</ul>
</li>
<li>確認設定並按一下<b>新增</b>。</li>
</ol>
<h4 class="list_head"><a name="s1" id="s1"></a>若要編輯一般設定：</h4>
<p>在<b>設定</b>頁籤，您可以進行許多一般設定，包含：PHP 快取、Xdebug、錯誤訊息的顯示以及 open_basedir。</p>
<ol>
<li>在<b>指令碼語言設定</b>頁面，選擇欲編輯的 PHP 設定檔並按一下<b>編輯</b>按鈕，或連按兩下欲編輯的 PHP 設定檔。</li>
<li>前往<b>設定</b>頁籤。</li>
<li>依照您的需求進行以下設定：
<ul>
<li><b>啟用 PHP 快取</b>：勾選核取方塊來加強 PHP 執行效能。然而，在某些情況下，此設定可能無法生效。</li>
<li><b>啟用 Xdebug</b>：勾選核取方塊來啟用 Xdebug (為 PHP 擴充模組，可提供除錯功能)。</li>
<li><b>啟用 display_errors 以顯示 PHP 錯誤訊息</b>：若要在網頁上顯示 PHP 錯誤訊息，請勾選此核取方塊。</li>
<li><b>open_basedir</b>：open_basedir 功能指的是 PHP 可存取檔案的路徑。
<ul>
<li>若要自訂 open_basedir，請選擇<b>自訂</b>，並於欄位輸入路徑。</li>
<li>若要使用系統預設設定，請選擇<b>系統預設</b>。</li>
</ul>
</li>
</ul>
</li>
<li>按一下<b>儲存</b>以套用設定。</li>
</ol>
<div class="section"><h4>注意：</h4>
<ul>
<li>請使用冒號 (:) 來區隔 open_basedir 路徑，例如：<b>/etc:/tmp:/usr/bin/php</b>。</li>
<li>為了確保安全性，<b>homes</b> 共用資料夾的路徑 (例如：<b>/volume1/homes</b>) 無法新增至 open_basedir。</li>
</ul>
</div>
<h4 class="list_head"><a name="s2" id="s2"></a>若要編輯擴充模組：</h4>
<p>在<b>擴充模組</b>頁籤，您可以管理擴充模組 (例如：bz2、curl、dba、gd、pgsql、session、sqlite3) 以自訂設定檔。</p>
<ol>
<li>在<b>指令碼語言設定</b>頁面，選擇欲編輯的 PHP 設定檔並按一下<b>編輯</b>按鈕，或連按兩下欲編輯的 PHP 設定檔。</li>
<li>前往<b>擴充模組</b>頁籤。</li>
<li>在擴充模組清單中勾選欲啟用的擴充模組。</li>
<li>按一下<b>儲存</b>以套用設定。</li>
</ol>
<div class="section"><h4>注意：</h4>
<ul>
<li>每一個套件設定檔含有一或多個必要的擴充模組。若擴充模組為必要，其對應的核取方塊便無法勾選。您只能管理非必要的擴充模組。</li>
</ul>
</div>
<h4 class="list_head"><a name="s3" id="s3"></a>若要編輯 FPM 設定：</h4>
<p>在 <b>FPM</b> 頁籤，您可以調整 PHP FastCGI Process Manager (FPM)，這可針對高負載網站提供 PHP 實作 FastCGI 的方式。</p>
<ol>
<li>在<b>指令碼語言設定</b>頁面，選擇欲編輯的 PHP 設定檔並按一下<b>編輯</b>按鈕，或連按兩下欲編輯的 PHP 設定檔。</li>
<li>前往 <b>FPM</b> 頁籤。</li>
<li>依照您的需求修改以下數值：<ul>
<li><b>FPM 模式</b>：您可以將 FPM 模式設定為<b>動態</b>、<b>靜態</b>或<b>因應需求</b>。</li>
<li><b>最大程序數</b></li>
<li><b>初始伺服器數</b></li>
<li><b>最小備用伺服器數</b></li>
<li><b>最大備用伺服器數</b></li>
</ul>
</li>
<li>按一下<b>儲存</b>以套用設定。</li>
</ol>
<div class="section"><h4>注意：</h4>
<ul>
<li>請參閱 <a href="http://php.net/manual/install.fpm.configuration.php" target="_blank">PHP 官方網站</a>取得更多關於 FPM 設定的資訊。</li>
</ul>
</div>
<h4 class="list_head"><a name="s4" id="s4"></a>若要編輯核心設定：</h4>
<p><b>核心設定</b>頁籤包含所有 PHP 設定檔的 php.ini 指令設定，例如：<b>sendmail_path</b> 及 <b>sendmail_from</b>。</p>
<ol>
<li>在<b>指令碼語言設定</b>頁面，選擇欲編輯的 PHP 設定檔並按一下<b>編輯</b>按鈕，或連按兩下欲編輯的 PHP 設定檔。</li>
<li>前往<b>核心設定</b>頁籤。</li>
<li>找到欲編輯的 php.ini 指令。您可以在搜尋方塊輸入名稱。</li>
<li>在特定指令的右欄輸入設定值。</li>
<li>按一下<b>儲存</b>以套用設定。</li>
</ol>
<h4 class="list_head">若要重設 php.ini 設定值：</h4>
<ol>
<li>在<b>指令碼語言設定</b>頁面，選擇欲編輯的 PHP 設定檔並按一下<b>編輯</b>按鈕，或連按兩下欲編輯的 PHP 設定檔。</li>
<li>前往<b>核心設定</b>頁籤。</li>
<li>從下拉式選單選擇<b>自訂</b>。所有曾經修改過的 php.ini 指令將顯示於此。</li>
<li>執行以下任一操作來重設 php.ini 設定值：<ul>
<li><b>重設已選項目</b>：按任一個 php.ini，並在下拉式選單中選取<b>重設已選項目</b>。您亦可按住「<b>Ctrl</b>」鍵來選擇多個 php.ini。</li>
<li><b>重設所有項目</b>：從下拉式選單中選擇<b>重設所有項目</b>。</li>
</ul>
</li>
<li>按一下<b>儲存</b>以套用設定。</li>
</ol>
<h2 class="list_head"><a name="t2" id="t2"></a>Python</h2>
<p>在 <b>Python</b> 頁籤，您可以新增、編輯、刪除自訂設定檔。</p>
<h4 class="list_head">若要新增自訂設定檔：</h4>
<ol>
<li>按一下<b>新增</b>。</li>
<li>填入<b>設定檔名稱</b>、<b>描述</b>等欄位。</li>
<li>從 <b>Python 版本</b>的下拉式選單中選取欲使用的 Python 後端版本並按<b>下一步</b>。</li>
<li>填入以下資訊以設定 uWSGI，然後按<b>下一步</b>。
<ul>
<li><b>程序</b>：可同時啟用 uWSGI 的程序數。</li>
<li><b>啟用執行緒</b>：預設每個程序包含一個執行緒。啟用此選項以允許一個程序包含多個執行緒。</li>
<li><b>執行緒數</b>：執行單一程序的執行緒數。</li>
<li><b>最大請求數</b>：程序將於請求數達最大上限時重新啟動。</li>
<li><b>緩衝區大小 (個位元組)</b>：每個請求封包表頭的緩衝區大小。</li>
</ul>
</li>
<li>您可以使用搜尋欄來搜尋模組，或按一下<b>瀏覽</b>按鈕以從本地儲存空間上傳需求檔案 (<a href="#s10">requirements.txt</a>)，以新增 Python 模組。按<b>下一步</b>。
<ul>
<li><b>模組名稱</b>：模組名稱。</li>
<li><b>預設版本</b>：您可以使用<b>最新版本</b>或<b>自訂</b>模組版本。範例如下：
<ul>
<li><i>Project_name</i></li>
<li><i>Project_name == 1.3</i></li>
<li><i>Project_name >=1.2,<2.0</i></li>
<li><i>Project_name[foo, bar]</i></li>
<li><i>Project_name~=1.4.2</i></li>
</ul>
</li>
<li><b>動作</b>：按一下 <img src="../images/script/red.png" width="20" height="20" alt="" class="inline"/> 以移除模組。</li>
</ul>
</li>
<li>確認設定並按一下<b>新增</b>。</li>
</ol>
<div class="section"><a name="s10" id="s10"></a><h4>注意：</h4>
<ul>
<li> 「requirements.txt」的檔案格式必須依照 Python 需求說明的格式規定，即：以專案名稱開頭，後面接選填的<a href="https://packaging.python.org/en/latest/glossary/#term-Version-Specifier" target="_blank">版本說明</a>。請參閱 <a href="https://pip.pypa.io/en/stable/cli/pip_install/#requirement-specifiers" target="_blank">pip 官方文件網站</a>取得更多關於需求說明的資訊。</li>
</ul>
</div>
<h4 class="list_head"><a name="s4" id="s4"></a>若要編輯一般設定：</h4>
<p>在<b>設定</b>頁籤，您可以編輯一般設定。</p>
<ol>
<li>在<b>指令碼語言設定</b>頁面，選擇欲編輯的 Python 設定檔並按一下<b>編輯</b>按鈕，或連按兩下欲編輯的 Python 設定檔。</li>
<li>前往<b>設定</b>頁籤。</li>
<li>依照您的需求編輯設定檔名稱、描述、Python 版本。</li>
<li>按一下<b>儲存</b>以套用設定。</li>
</ol>
<h4 class="list_head"><a name="s5" id="s5"></a>若要編輯 uWSGI 設定：</h4>
<p>在 <b>uWSGI</b> 頁籤，您可以調整 Python uWSGI，此設定為一種針對高負載網站提供 Python 實作 uWSGI 的方式。</p>
<ol>
<li>在<b>指令碼語言設定</b>頁面，選擇欲編輯的 Python 設定檔並按一下<b>編輯</b>按鈕，或連按兩下欲編輯的 Python 設定檔。</li>
<li>前往 <b>uWSGI</b> 頁籤。</li>
<li>依照您的需求編輯下列數值：
<ul>
<li><b>程序</b>：可同時啟用 uWSGI 的程序數。</li>
<li><b>啟用執行緒</b>：預設每個程序包含一個執行緒。啟用此選項以允許一個程序包含多個執行緒。</li>
<li><b>執行緒數</b>：執行單一程序的執行緒數。</li>
<li><b>最大請求數</b>：程序將於請求數達最大上限時重新啟動。</li>
<li><b>緩衝區大小 (個位元組)</b>：每個請求封包表頭的緩衝區大小。</li>
</ul>
</li>
<li>按一下<b>儲存</b>以套用設定。</li>
</ol>
<div class="section"><h4>注意：</h4>
<ul>
<li>請參閱 <a href="https://uwsgi-docs.readthedocs.io/en/latest/Options.html?highlight=options" target="_blank">uWSGI 官方文件網站</a>取得更多關於 uWSGI 設定的資訊。</li>
</ul>
</div>
<h4 class="list_head"><a name="s6" id="s6"></a>若要編輯模組：</h4>
<p>在<b>模組</b>頁籤，您可以管理 Flask 與 Django 等擴充模組以自訂設定檔。</p>
<ol>
<li>在<b>指令碼語言設定</b>頁面，選擇欲編輯的 Python 設定檔並按一下<b>編輯</b>按鈕，或連按兩下欲編輯的 Python 設定檔。</li>
<li>前往<b>模組</b>頁籤。</li>
<li>您可以使用搜尋欄來搜尋模組，或按一下<b>瀏覽</b>按鈕以從本地儲存空間上傳需求檔案 (<a href="#s11">requirements.txt</a>)，以新增 Python 模組。
<ul>
<li><b>模組名稱</b>：模組名稱。</li>
<li><b>預設版本</b>：選擇<b>最新版本</b>以使用最新版本，或選擇<b>自訂</b>以自訂模組版本。範例如下：
<ul>
<li><i>Project_name</i></li>
<li><i>Project_name == 1.3</i></li>
<li><i>Project_name >=1.2,<2.0</i></li>
<li><i>Project_name[foo, bar]</i></li>
<li><i>Project_name~=1.4.2</i></li>
</ul>
</li>
</li>
<li><b>動作</b>：按一下 <img src="../images/script/red.png" width="20" height="20" alt="" class="inline"/> 以移除模組。</li>
</ul>
</li>
<li>按一下<b>儲存</b>以套用設定。</li>
</ol>
<div class="section"><a name="s11" id="s11"></a><h4>注意：</h4>
<ul>
<li> 「requirements.txt」的檔案格式必須依照 Python 需求說明的格式規定，即：以專案名稱開頭，後面接選填的<a href="https://packaging.python.org/en/latest/glossary/#term-Version-Specifier" target="_blank">版本說明</a>。請參閱 <a href="https://pip.pypa.io/en/stable/cli/pip_install/#requirement-specifiers" target="_blank">pip 官方文件網站</a>取得更多關於需求說明的資訊。</li>
</ul>
</div></body>
</html>