PHP 5 物件模型詳解：zend_object_value、PHP_METHOD、可見性與介面實作

重建 sample3 擴展骨架

php-src/ext/sample3/
├── config.m4
├── php_sample3.h
└── sample3.c

類別定義與方法實作

#include "php_sample3.h"

zend_class_entry *php_sample3_sc_entry;

#define PHP_SAMPLE3_SC_NAME "Sample3_SecondClass"

// 方法實作：使用 PHP_METHOD 宏 (封裝 PHP_FUNCTION + 類別名)
PHP_METHOD(Sample3_SecondClass, helloWorld) {
    php_printf("Hello World\n");
}

// 靜態方法範例
PHP_METHOD(Sample3_SecondClass, staticGreet) {
    php_printf("Static Greeting\n");
}

// 方法表定義
static function_entry php_sample3_sc_functions[] = {
    PHP_ME(Sample3_SecondClass, helloWorld, NULL, ZEND_ACC_PUBLIC)
    PHP_ME(Sample3_SecondClass, staticGreet, NULL, ZEND_ACC_PUBLIC | ZEND_ACC_STATIC)
    PHP_MALIAS(Sample3_SecondClass, sayHi, helloWorld, NULL, ZEND_ACC_PUBLIC)
    PHP_ME_MAPPING(hello, sample_hello_world, NULL)  // 映射程序式函式
    {NULL, NULL, NULL}
};

PHP_MINIT_FUNCTION(sample3) {
    zend_class_entry ce;
    INIT_CLASS_ENTRY(ce, PHP_SAMPLE3_SC_NAME, php_sample3_sc_functions);
    
    // 註冊內部類別
    php_sample3_sc_entry = zend_register_internal_class(&ce TSRMLS_CC);
    
    // 宣告屬性 (可見性控制)
    zend_declare_property_long(php_sample3_sc_entry, "publicProp", strlen("publicProp"), 0, ZEND_ACC_PUBLIC TSRMLS_CC);
    zend_declare_property_long(php_sample3_sc_entry, "protectedProp", strlen("protectedProp"), 0, ZEND_ACC_PROTECTED TSRMLS_CC);
    zend_declare_property_long(php_sample3_sc_entry, "privateProp", strlen("privateProp"), 0, ZEND_ACC_PRIVATE TSRMLS_CC);
    zend_declare_property_long(php_sample3_sc_entry, "staticProp", strlen("staticProp"), 0, ZEND_ACC_STATIC | ZEND_ACC_PUBLIC TSRMLS_CC);
    
    // 宣告類別常數
    zend_declare_class_constant_long(php_sample3_sc_entry, "VERSION", strlen("VERSION"), 1 TSRMLS_CC);
    
    return SUCCESS;
}

方法定義宏家族詳細解析

可見性與修飾旗標 (ZEND_ACC_*)

組合方式：位元或運算 ZEND_ACC_PUBLIC | ZEND_ACC_STATIC。

介面定義範例

zend_class_entry *php_sample3_iface_entry;

static function_entry php_sample3_iface_functions[] = {
    PHP_ABSTRACT_ME(Sample3_Interface, doSomething, NULL)
    PHP_ABSTRACT_ME(Sample3_Interface, getValue, NULL)
    {NULL, NULL, NULL}
};

PHP_MINIT_FUNCTION(sample3) {
    // ... 前面類別註冊 ...
    
    zend_class_entry ice;
    INIT_CLASS_ENTRY(ice, "Sample3_Interface", php_sample3_iface_functions);
    ice.ce_flags |= ZEND_ACC_INTERFACE; // 標記為介面
    php_sample3_iface_entry = zend_register_internal_interface(&ice TSRMLS_CC);
    
    // 類別實作介面
    zend_class_implements(php_sample3_sc_entry TSRMLS_CC, 1, php_sample3_iface_entry);
    
    return SUCCESS;
}

物件建立與屬性存取 (內部 API)

// 建立物件實例
zval *obj;
MAKE_STD_ZVAL(obj);
object_init_ex(obj, php_sample3_sc_entry);

// 寫入屬性
zend_update_property_long(php_sample3_sc_entry, obj, "publicProp", strlen("publicProp"), 42 TSRMLS_CC);

// 讀取屬性
zval **prop = zend_read_property(php_sample3_sc_entry, obj, "publicProp", strlen("publicProp"), 1 TSRMLS_CC);
long val = Z_LVAL_PP(prop);

// 靜態屬性存取
zval *static_prop = zend_read_static_property(php_sample3_sc_entry, "staticProp", strlen("staticProp"), 1 TSRMLS_CC);
Z_LVAL_P(static_prop) = 100;

特殊方法 (魔術方法) 支援

PHP 5 支援 __construct、__destruct、__call、__get、__set、__isset、__unset、__sleep、__wakeup、__toString、__invoke、__clone 等，內部以 ZEND_ACC_PUBLIC 註冊，引擎自動於對應時機呼叫。

1. 上一篇文章： PHP 4 物件模型詳解：從結構體到 zend_class_entry 註冊流程
2. 下一篇文章： PHP 擴展生命週期四大鉤子：MINIT/MSHUTDOWN/RINIT/RSHUTDOWN 詳細實作

PHP 綜合知識

PHP+MySQL 投票系統設計與實現全記錄（含觸發器、PDO、JS 前端）

系統架構概覽 三步走：數據庫設計 → 系統框架（PDO 封

PHP 遠程文件名搜索器：FTP/服務器目錄遞歸掃描、關鍵字匹配、結果統計 Web 介面

功能演示 輸入掃描路徑（如 /var/www/html）與

PHP 程式碼優化 24 條鐵律：從語法細節到架構思維的效能提升指南

前言：優化的真諦 PHP 優化的核心目標是「以最小代價換取最

PHP cURL 模擬 POST 請求並下載 .torrent 檔案：從輸出內容到檔案下載的完整轉換

問題場景 cURL 取得遠端 .torrent 檔案內容，預