PHP 安裝與配置

您可以使用這項程序來設定 PHP 以搭配「管理主控台」使用。

開始之前

需求:

關於這項作業

請遵循本節的指示來為 Apache HTTP Server 或其他 Web 伺服器配置 PHP。這些指示假設您已下載所需的 PHP 版本。

安裝 PHP

關於這項作業

本節說明如何從原始檔編譯及安裝 PHP。如果您有現有的 PHP 安裝架構且不要重新編譯,您只需要決定是否已安裝適當的資料庫驅動程式。如果您需要安裝資料庫驅動程式,請參閱 PHP 文件以得知可使用的安裝方法。請依下列方式安裝要與 Build Forge 搭配使用之資料庫的資料庫驅動程式:
  • DB2:ibm_db2 驅動程式
  • MySQL:mysqli 驅動程式
  • Oracle Instant Client:oci8 驅動程式
註: 目前,完整的 Oracle 用戶端與 PHP oci8 不相容。請僅使用 Oracle Instant Client。

程序

  1. 配置 PHP 以便在您剛才建立的工作目錄中進行安裝。
    $ ./configure --prefix=/usr/local/php-5.2.4 --with-<database>=shared \
    --with-apxs2 --with-ldap=shared --enable-mbstring --enable-shmop \
    --with-xml --with-zlib=shared
    取代 --with-<database>,如下所示:
    • DB2:--with-ibm_db2[=dir]。 如果未指定 =dir,則會使用預設值:/home/db2inst1/sqllib
    • MySQL:--with-mysqli[=file]。選用的 file 參數是 mysql_config 的路徑名稱。
    • Microsoft SQL Server:--with-mssql[=dir]
    • Oracle:您必須安裝另一個 Oracle Instant Client 安裝架構,才能使用 PHP oci8。當您使用 Oracle Instant Client 來連接資料庫時,請使用 --with-oci8=instantclient,lib,其中 lib 是 Instant Client lib 目錄的路徑。

    請注意程式碼區塊中的行接續字元 \。此步驟會指定將安裝 PHP 的位置,以及將要安裝哪些選項。依預設它會安裝在 /usr/local 中。範例顯示如何將它放在 /usr/local/php-5.2.4 中。此位置會在稍後範例中用到。

  2. 編譯 PHP。
    $ make

    此步驟可在您的本端目錄中編譯執行檔。

  3. 安裝 PHP(以 root 身分執行)。
    # make install
    此步驟必須由有權寫入 Apache 安裝目錄(本範例中為 /usr/local/apache-2.2.4)的使用者來執行。通常是以 root 身分來執行,您的本端管理設定可能有所不同。

配置 PHP

程序

  1. 將延伸檔複製到延伸檔目錄中。 資料庫的延伸檔必須從儲存庫中複製到作用中的延伸檔目錄。下例假設 PHP 安裝在 /usr/local/php-5.2.4 中。請注意,<datestamp> 是一串數字。
    $ cd /usr/local/php-5.2.4/lib/php/extensions/no-debug-non-zts-<datestamp>/
    $ cp <db-extensions> ..
    <db-extensions> 檔必須對應於您的 Build Forge 資料庫,如下所示:
    • DB2:ibm_db2.so
    • MySQL:mysql.somysqli.so
    • Oracle:oci8.so
  2. 編輯 PHP 配置檔 php.ini 下例假設 PHP 安裝在 /usr/local/php-5.2.4 中:
    $ cd /usr/local/php-5.2.4/lib/
    $ vi php.ini
    新增下列項目:
    extension_dir=/usr/local/php-5.2.4/lib/php/extensions
    upload_tmp_dir=<directory>
    extension=<db-extension-so>
    請使用 <db-extensions-so> 作為資料庫的檔名,如下所示:
    • DB2:extension=ibm_db2.so
    • MySQL:兩個項目 -
      extension=mysql.so
      extension=mysqli.so
    • Oracle:extension=oci8.so
    註: Apache Web 伺服器執行身分的使用者必須能夠寫入 upload_tmp_dir 所用的目錄。通常該使用者為 nobody,但可能因您的本端管理實務而有所不同。

編輯 Apache 配置檔

程序

編輯 Apache 配置檔。在 httpd.conf 中新增 PHP 的相關資訊。
cd <apache-dir>
vi httpd.conf
新增下列數行:
LoadModule php5_module modules/libphp5.so
AddHandler php5-script .php
AddType text/html .php
DirectoryIndex index.php

識別 Proxy 伺服器

關於這項作業

選用:只有當「管理主控台」必須使用 Proxy 伺服器來存取其資料庫時才需要執行此步驟。

程序

編輯 PHP 配置檔 php.ini 此檔案位於 <php-install>/lib 中,例如:/usr/local/php-5.2.4

新增下列項目:

bf_proxyHost=<your_proxy_server_hostname>
bf_proxyPath=<your_proxy_path>
bf_symlinkPath=<symlink_to_proxy_path>

意見