安装和配置¶

安装要求¶

PHP 版本要求：PHP5.3-5.6, PHP7.0-7.2, PHP7.3, PHP7.4, PHP8.0

警告

Zend Framework 要求 PHP版本不低于5.1.4，但强烈建议使用 5.2.3 或更高版本，因为在这两个版本之间有许多重大安全和性能方面的改善和提高。

因为神通方言版 Zend Framework 依赖 PDO_ACI 驱动，而目前神通 PDO_ACI 支持的 PHP 版本为 PHP5.3-5.6 和 PHP7.0-7.2, PHP7.3, PHP7.4, PHP8.0, 所以目前神通方言版 Zend Framework 支持的 PHP 版本要与 PDO_ACI 一致。

支持版本¶

目前神通适配了主流的 Zend Framework 几个版本，列表如下

Zend Framework 1.10.3
Zend Framework 2.4
Zend Framework 2.9
Zend Framework 2.10
Zend Framework 2.11

PDO_ACI 验证¶

安装神通方言 Zend Framework 之前，先检查 PDO_ACI 是否已加载到当前的 PHP 运行时环境中。

执行命令 php -m | grep PDO_ACI, 如果输出项查询到 PDO_ACI，那么当前PHP运行时已加载 PDO_ACI; 否则需要正确加载 PDO_ACI 扩展库。

root@deb10:~# php -m | grep PDO_ACI
PHP Warning:  Module 'PDO_ACI' already loaded in Unknown on line 0
Warning: Module 'PDO_ACI' already loaded in Unknown on line 0
PDO_ACI

加载 PDO_ACI 扩展库详细内容请参考 PDO_ACI 开发手册 -> 安装与配置

方言安装¶

神通方言适配了多个版本，请根据对应的版本安装。

Zend Framework 1.x¶

ZendFramework-1.10.3 目录内容

ZendFramework-1.10.3/
├── library
│   └── Zend
│       └── Db
│           ├── Adapter
│           │   └── Pdo
│           │       └── Aci.php
│           └── Statement
│               └── Pdo
│                   └── Aci.php
└── README.md
7 directories, 3 files

将 ZendFramework-1.10.3 目录内文件拷贝到 zend 开发环境相对应的目录，注意只替换最底层文件，请勿替换整个文件夹。

ZendFramework-1.10.3/library/Zend/Db/Adapter/Pdo/Aci.php 拷贝到 $Zend/Db/Adapter/Pdo/ 文件夹下，与 Oci.php 等文件放在同一目录

ZendFramework-1.10.3/library/Zend/Db/Statement/Pdo/Aci.php 拷贝到 $Zend/Db/Statement/Pdo/ 文件夹下，与 Oci.php 等文件放在同一目录

Zend Framework 2.x¶

ZendFramework-2.4 目录内容

ZendFramework-2.4/
├── library
│   └── Zend
│       └── Db
│           ├── Adapter
│           │   ├── Adapter.php
│           │   ├── Driver
│           │   │   └── Pdo
│           │   │       ├── Connection.php
│           │   │       ├── Feature
│           │   │       │   └── OscarRowCounter.php
│           │   │       └── Pdo.php
│           │   └── Platform
│           │       └── Oscar.php
│           ├── Metadata
│           │   ├── Metadata.php
│           │   └── Source
│           │       └── OscarMetadata.php
│           └── Sql
│               └── Platform
│                   ├── Oscar
│                   │   ├── Oscar.php
│                   │   └── SelectDecorator.php
│                   └── Platform.php
└── README.md
13 directories, 11 files

将目录下 library/Zend/Db/ 所有文件拷贝到 ZendFramework 环境对应的目录下。

例如，当前开发环境下zf-webapp项目 ZendFramework 2.4 版本，安装神通方言支持，将对应的神通方言 ZendFramework-2.4 目录下library/Zend/Db/* 拷贝到

cp -r php_pdo_aci/ORM/ORM-ZendFramework/ZendFramework-2.4/library/Zend/Db/* zf-webapp/vendor/zendframework/zendframework/library/Zend/Db/

其它ZendFramework-2.x版本与 ZendFramework-2.4 安装方法类似。

警告

注意：请确保 ZendFramework 版本与神通方言 ZendFramework 版本对应。