zendAPI 的 CMake 參數詳解

zendAPI 是採用 CMake 進行編譯的，咱們在項目中定義了一些 CMake 的函數，變量和選項，下面咱們在這篇文章中對這些進行詳細的說明，有助於節省你們的時間。

CMake 內置重要變量

CMAKE_INSTALL_PREFIX

類型：字符串
默認值：/usr/local
描述：編譯完成以後，軟件包安裝的路徑

CMAKE_BUILD_TYPE

類型：字符串
默認值：空字符串
描述：控制軟件編譯的類型，可能的取值：

1. Debug 調試模式，開發的時候指定
2. Release 發佈模式，發佈軟件包的時候指定
3. RelWithDebInfo
4. MinSizeRel

BUILD_SHARED_LIBS

類型：布爾型
默認值：無
描述：指定爲 ON 的時候，項目中的庫默認編譯成動態連接庫，除非特定的庫從新指定了這個選項。

CMAKE_CXX_FLAGS

類型：字符串
默認值：無
描述：這個變量的值將會傳遞給 C++ 編譯器, 好比 -std=c++11 等等參數。

自定義選項 (option)

ZAPI_OPT_ENABLE_TESTS

類型：布爾型
默認值：OFF
描述：控制 zendAPI 是否編譯單元測試，若是值爲 ON 則開啓，OFF 則關閉。

ZAPI_OPT_ENABLE_VERBOSE_DEBUG

類型：布爾型
默認值：OFF
描述：控制 zendAPI 是否輸出一些調試信息，這個選項只在 Debug 模式下指定，在其餘模式下請設置爲 OFF。

ZAPI_OPT_PHP_ROOT_PATH

類型：字符串
默認值：無
描述：當咱們開發的時候 PHP 的安裝路徑沒有在標準的路徑下，zendAPI 的編譯系統可能探測不到您的 PHP， 這個時候您能夠將您的自定義的路徑指定到這個變量。
例如咱們編譯的 PHP 版本是 7.1.5, 咱們的安裝路徑可能指定爲 /usr/local/php-7.1.5, 那麼咱們能夠在 CMake 命令行指定 cmake -DZAPI_OPT_PHP_ROOT_PATH=/usr/local/php-7.1.5。

ZAPI_OPT_PHP_INCLUDE_PATH

類型：字符串
默認值：無
描述：在一些 Linux 發行版裏面，有時候頭文件會被安裝到一個特殊的路徑中, 好比 Ubuntu 裏面有可能在 /usr/local/include/php/ 後面跟有一串數字，這個時候 zendAPI 的編譯系統探測不到 PHP的頭文件，這個時候您能夠指定這個選項，指定您系統中特殊的 PHP 頭文件路徑。

ZAPI_OPT_PHP_LIB_PATH

類型：字符串
默認值：無
描述：參考 ZAPI_OPT_PHP_INCLUDE_PATH 當 libphp 庫在非主流的路徑下的時候能夠指定這個變量，幫助 zendAPI 編譯系統進行探測。

ZAPI_OPT_PHP_BIN_PATH

類型：字符串
默認值：無
描述：參考 ZAPI_OPT_PHP_INCLUDE_PATH 當 PHP 可執行文件在非主流的路徑下的時候能夠指定這個變量，幫助 zendAPI 編譯系統進行探測。

高級

如下的文檔若是不是研究 zendAPI 源碼就不須要了解。

自定義選項 (option)

等待完善 ...

自定義變量

等待完善 ...

自定義函數

等待完善 ...