蔡逸竹

《PHP》『選項與資訊函式庫』assert 如果assertion是false則檢查

assert ---  如果assertion是false則檢查

語法 : int assert (string|bool assertion)

說明 :

如果它的結果是false，assert( )將會檢查給予的assertion並且取適當的動作。字串assertion的優點是較少在頭上的(less overhead)，當assertion檢查結束，並且訊息包含了assertion表示，當assertion失敗。

assertion應該用來像是除錯的特色而已，你可以使用它們來做健全的檢查(sanity-checks)來探測狀態(conditions)，這將永遠為true而且指出一些程式錯誤。

assertions將不用來作為正常的執行運作，像是輸入參數的檢查。如果assertion檢查是非活性化的(not activated)，將永遠能作糾正(correct)。

assert( )的性能，可由assert_option( )或是.ini-setting來配置。

[ 本帖最後由 蔡逸竹 於 2006-9-24 01:16 編輯 ]

蔡逸竹

assert_options ---  設定(取得)各式的assert旗標

語法 : mixed assert_options (int what [, mixed value])

說明 :

使用assert_options( )你可以設定各式的assert( )控制選項，或只是查詢它們目前的設定。

assert選項 :

選項                                 ini-參數                 預設值               說明
ASSERT_ACTIVE              assert.active              1            使assert( )能夠計算
ASSERT_WARNING          assert.warning           1            assertion失敗時發佈PHP警告
ASSERT_BAIL                   assert.bail                  0            assertion失敗時終止執行
ASSERT_QUIET_EVAL     assert.quiet_eval        0           在assertion表達計算期間使無法error_reporting
ASSERT_CALLBACK         assert_callback        (null)         assertion失敗時呼叫使用者函式

assert_options( )將傳回任何選項的原先設定值，失敗則傳回false。

蔡逸竹

error_log ---  送出錯誤訊息到某處

語法 : int error_log (string message, int message_type [, string destination [, string extra_headers]])

說明 :

送出一個錯誤訊息到web伺服器的錯誤記錄，一個TCP埠號或是一個檔案。第一個參數message是將要被記錄的一個錯誤訊息內容，第二個參數message_type說明訊息要送往何處 :

error_log( )記錄的型態 :

0 message送到PHP的系統記錄者，使用作業系統的系統記錄機制或是檔案，取決於error_log的設定值。
1 以email的方式將message送到參數destination指定的地址，只有這個型態才會使用到extra_headers，此型態使用相同的內部函式mail( )。
2 message送到PHP除錯連結，只有在遠端的除錯設為enable時，這個選項才有效。參數destination用來指定接收除錯訊息的主機名稱或是IP位址，埠號。
3 message附加在檔案destination。

Example :

<?php

   // Send notification through the server log if we can not

  // connect to the database.

  if (!Ora_Logon($username, $password)) {

       error_log("Oracle database not available!", 0);

  }

  // Notify administrator by email if we run out of FOO

  if (!($foo = allocate_new_foo()) {

        error_log ("Big trouble, we're all out of FOOs!", 1, "operator@mydomain.com");

  }

  // other ways of calling error_log():

  error_log ("You messed up!", 2, "127.0.0.1:7000");

  error_log ("You messed up!", 2, "loghost");

  error_log ("You messed up!", 3, "/var/tmp/my-errors.log");

?>     

蔡逸竹

error_reporting ---  設定PHP錯誤回報等級

語法 : int error_reporting ([int level])

說明 :

設定PHP的錯誤回報等級並且傳回舊的等級。錯誤回報等級是一位元罩，有下列的值 :

值 內部的名稱
1 E_ERROR
2 E_WARNING
4 E_PARSE
8 E_NOTICE
16 E_CORE_ERROR
32 E_CORE_WARNING

E_ERROR : 預設上是列出錯誤，並且在函式傳回之後終止程式的執行

E_WARNING : 預設上是列出警告，但是不中斷程式的執行

E_PARSE : 剖析語法上的錯誤

E_NOTICE : 預設上是列出注意，並且指出程式衝突的地方

E_CORE_ERROR : 這像是E_ERROR，不同處在於它是由PHP的核心所產生的，函式將不會產生此型態的錯誤

E_CORE_WARNING : 這像是E_WARNING，不同處在於它是由PHP的核心所產生的，函式將不會產生此型態的錯誤

蔡逸竹

extension_loaded ---  判斷擴充模組是否已載入

語法 : bool extension_loaded (string name)

說明 :

如果參數name指定的擴充模組已載入則此函式傳回true，你可以使用phpinfo( )來看見各種擴充模組的名稱。

注意 : 這是PHP3.0.10.中新增的函式

參考 : phpinfo( )

蔡逸竹

getenv ---  取得環境變數的值

語法 : string getenv (string varname)

說明 :

傳迴環境變數varname的值，發生錯誤則傳回false。

Example :

<?php

   $ip = getenv ("REMOTE_ADDR"); // get the ip number of the user

?>

你可以使用phpinfo( )來看見所有環境變數的列表。

蔡逸竹

get_cfg_var ---  取得PHP結構選項的值

語法 : string get_cfg_var (string varname)

說明 :

傳回PHP結構(configuration)變數varname目前的值，發生錯誤則傳回false。

當PHP在編譯(compiled)的時候，它將不會傳回結構資訊，或從Apache結構檔案讀取。

可以試著獲得cfg_file_path結構設定的值，來檢查系統是否使用結構檔案(在PHP3中叫作php3.ini，而在PHP4中則叫作php.ini)。

蔡逸竹

get_current_user ---  取得目前PHP程式擁有者的名稱

語法 : string get_current_user (void)

說明 :

傳回目前PHP程式擁有者的名稱。

參考 : getmyuid( )  getmypid( )  getmyinode( )  getlastmod( )

蔡逸竹

get_magic_quotes_gpc ---  取得目前magic_quotes_gpc的設定值

語法 : long get_magic_quotes_gpc (void)

說明 :

傳回目前magic_quotes_gpc的設定值，0表示關閉，1表示開啟。

參考 : get_magic_quotes_runtime( )  set_magic_quotes_runtime( )

蔡逸竹

get_magic_quotes_runtime ---  取得目前magic_quotes_runtime的設定值

語法 : long get_magic_quotes_runtime (void)

說明 :

傳回目前magic_quotes_runtime的設定值，0表示關閉，1表示開啟。

參考 : get_magic_quotes_gpc( )  set_magic_quotes_runtime( )