达梦 PDO 模块是在 PHP 开放源码的基础上，基于 PHP-PDO 模块开发的一个动态扩展库。其中，接口的实现参考了 PDO-ODBC 的调用逻辑，内部调用达梦 DPI 接口来实现 PHP 应用程序访问 DM 数据库服务器。

本文主要是针对在 CentOS 7 / Kylin V10 等操作系统下，加载达梦 PDO 接口失败的情况进行补充说明。文中版本为 PHP7.2 NTS 。

安装

1、PHP 安装
可参考安装文档：获取 PHP 源码并编译
2、Apache/NGINX 安装 略
3、DM8 安装
可参考安装文档：
达梦数据库 Windows 安装
达梦数据库 Linux 安装

注：如果您已安装达梦数据库，那么：

• 在$DM_HOME/drivers/php_pdo/目录下您可以找到所有达梦已经支持的 PHP 版本。请注意带 ts 的接口模块对应 PHP TS 版本，不带 ts 的对应 PHP NTS。
• 达梦相关依赖库目录已被加入到系统环境变量$LD_LIBRARY_PATH。
• 详细接口使用，参考达梦手册《DM8程序员手册.pdf》中 DM PHP 编程指南章节。

加载模块

前置条件

$DM_HOME/bin已写入系统环境变量$LD_LIBRARY_PATH
（正常安装达梦已自动写入）。如果没有，请手动加入。

由于达梦 PDO 模块依赖于 PHP 的 PDO 扩展，使用前请自行安装 PHP-PDO 扩展。检验是否已安装 PHP-PDO 扩展：

[root@FT105126 ~]# php -m | grep PDO
PDO

开始配置达梦 PDO 模块

方法一：
/etc/php.ini中添加配置：

extension=pdo.so
extension=php72_pdo_dm.so

然后修改/etc/php.d/20-pdo.ini

extension=pdo

方法二：
添加文件/etc/php.d/30-pdo_dm.ini

Enable pdo_dm extension module
extension=php72_pdo_dm.so

3. 配置完成后，检查驱动是否正常

[root@FT105126 ~]# php -m | grep PDO
PDO
PDO_DM

至此，达梦 PDO 模块已经能正确加载到 PHP 中了。

httpd/php-fpm 服务解决方法

某些版本/操作系统中，httpd/php-fpm 服务不能正常启动，会报错：
NOTICE: PHP message: PHP Fatal error: Unable to start PDO_DM 。

分析发现，这些版本的 httpd/php-fpm 启动时，没有加载系统环境变量$LD_LIBRARY_PATH。由于达梦 PDO 模块依赖于其他的达梦模块，导致服务无法正常启动。

httpd 服务启动

1. 修改 httpd.service（如果不存在 EnvironmentFile 项，手动加入）。

[root@ecs-65a0 nginx]# cat /usr/lib/systemd/system/httpd.service 
[Unit]
Description=The Apache HTTP Server
After=network.target remote-fs.target nss-lookup.target
Documentation=man:httpd(8)
Documentation=man:apachectl(8)

[Service]
Type=notify
EnvironmentFile=/etc/sysconfig/httpd
ExecStart=/usr/sbin/httpd $OPTIONS -DFOREGROUND
ExecReload=/usr/sbin/httpd $OPTIONS -k graceful
ExecStop=/bin/kill -WINCH ${MAINPID}
# We want systemd to give httpd some time to finish gracefully, but still want
# it to kill httpd after TimeoutStopSec if something went wrong during the
# graceful stop. Normally, Systemd sends SIGTERM signal right after the
# ExecStop, which would kill httpd. We are sending useless SIGCONT here to give
# httpd time to finish.
KillSignal=SIGCONT
PrivateTmp=true

[Install]
WantedBy=multi-user.target

2.修改 /etc/sysconfig/httpd（文件不存在，需添加文件）

[root@ecs-65a0 nginx]# cat /etc/sysconfig/httpd 
#
# This file can be used to set additional environment variables for
# the httpd process, or pass additional options to the httpd
# executable.
#
# Note: With previous versions of httpd, the MPM could be changed by
# editing an "HTTPD" variable here.  With the current version, that
# variable is now ignored.  The MPM is a loadable module, and the
# choice of MPM can be changed by editing the configuration file
# /etc/httpd/conf.modules.d/00-mpm.conf.
# 

#
# To pass additional options (for instance, -D definitions) to the
# httpd binary at startup, set OPTIONS here.
#
#OPTIONS=

#
# This setting ensures the httpd process is started in the "C" locale
# by default.  (Some modules will not behave correctly if
# case-sensitive string comparisons are performed in a different
# locale.)
#
LANG=C
LD_LIBRARY_PATH=/opt/dmdbms/bin:

3. 重启 httpd 服务成功

[root@FT105126 ~]# service httpd restart
Redirecting to /bin/systemctl restart httpd.service

php-fpm 服务启动

1. 修改 php-fpm.service（如果不存在 EnvironmentFile 项，需手动加入）

[root@ecs-65a0 nginx]# cat /etc/sysconfig/php-fpm
# Additional environment file for php-fpm
LD_LIBRARY_PATH=:/opt/dmdbms/bin

[root@ecs-65a0 nginx]# cat /usr/lib/systemd/system/php-fpm.service 
[Unit]
Description=The PHP FastCGI Process Manager
After=syslog.target network.target

[Service]
Type=notify
PIDFile=/var/run/php-fpm/php-fpm.pid
EnvironmentFile=/etc/sysconfig/php-fpm
ExecStart=/usr/sbin/php-fpm --nodaemonize --fpm-config /etc/php-fpm.conf
ExecReload=/bin/kill -USR2 $MAINPID
PrivateTmp=true

[Install]
WantedBy=multi-user.target

[root@ecs-65a0 nginx]#

2. 修改 /etc/sysconfig/php-fpm （若文件不存在，需添加文件）

[root@ecs-65a0 nginx]# cat /etc/sysconfig/php-fpm
# Additional environment file for php-fpm
LD_LIBRARY_PATH=/opt/dmdbms/bin:

3. 重启 php-fpm 服务成功

[root@FT105126 ~]# service php-fpm restart
Redirecting to /bin/systemctl restart php-fpm.service