GoEmPHP 技术文档

1. 安装指南

GoEmPHP 是一个用于将 PHP 嵌入到 Golang 的包。以下是安装步骤：

首先，下载包，注意必须指定 -d 参数：

go get -d github.com/mikespook/goemphp

接下来，运行 bootstrap.sh 脚本来准备嵌入式 PHP 库。该脚本有一个参数，可以是以下四个值之一：5.4、5.5、5.6 或 ng。

例如：

./bootstrap.sh 5.6

将会执行 wget、configure 和 make 来生成 libphp5.so 文件，该文件用于嵌入 PHP。这个过程可能需要较长时间。当您看到 Congratulations!!! 消息时，意味着您已经成功获取了正确的 .so 文件，并放置在 ./php-lib/libs/ 目录中。您可以手动检查该文件。

第三个步骤是调用 go generate 命令来准备源文件，这些文件将被编译：

如果生成过程中没有报告任何问题，那么您可以调用 go build 命令来编译 GoEmPHP。

完成以上步骤后，请使用 ./test.sh 脚本测试包。当然，您也可以手动运行 go test -ldflags="-r ./php-lib/libs/"，或者将 .so 文件放入系统库目录中，然后运行 go test。在应用程序中使用此库时，应采用相同的库机制。

2. 项目的使用说明

GoEmPHP 包的使用非常简单。以下是一个示例：

script := php.New()
script.Startup()
defer script.Close()
if err := script.Eval("phpinfo();"); err != nil {
    log.Fatal(err)
}
if err := script.Exec("foobar.php"); err != nil {
    log.Fatal(err)
}

更多示例，请参考源代码中的 php_test.go。

3. 项目API使用文档

GoEmPHP 提供了以下主要方法供用户使用：

• New(): 创建一个新的 PHP 脚本实例。
• Startup(): 启动 PHP 环境。
• Close(): 关闭 PHP 环境。
• Eval(string): 执行 PHP 代码字符串。
• Exec(string): 执行 PHP 文件。

在使用这些方法时，请确保正确处理错误。

4. 项目安装方式

项目的安装方式已在“安装指南”部分详细说明。简要概括如下：

1. 使用 go get 命令下载包。
2. 运行 bootstrap.sh 脚本准备 PHP 库。
3. 调用 go generate 准备源文件。
4. 使用 go build 编译项目。
5. 运行测试脚本来验证安装。

以上就是 GoEmPHP 的技术文档。希望对您有所帮助。