通达OA二次开发手册V12

环境编码

UTF-8 包括PHP、MySQL、nginx等

PHP、MySQL版本

PHP7.2 由 PHP5.4 升级为 PHP7.2 64位

MySQL5.7 由 MySQL5.6 升级为 MySQL5.7 64位

PHP版本升级已弃用功能

each() 函数已弃用，建议使用 foreach()

语法样例： $arr = [1, 2, 3, 4]; foreach($arr as $key => $val) { echo "\$a[$key] => $val "; } 输出结果： $a[0] => 1 $a[1] => 2 $a[2] => 3 $a[3] => 4

PHP版本升级兼容

1    由于php7+不支持php_mysql.dll，所以需要改为php_mysqli.dll，有关MySQL的函数需要调整为 mysqli相关函数，代码中遇到请注意

mysql 转 mysqli 相关兼容

mysql_connect(host, user, pwd, connection) 替换 mysqli_connect(host, user, pwd, db) mysql_query($q, $c) 替换 mysqli_query($c, $q)

mysql_select_db($db, $c) 替换 mysqli_select_db($c, $db)

mysql_field_name 已弃 解决方案参考：关于如何解决mysqli()没有与之对应mysqli_field_name()问题 - 知乎 mysql_field_name — (mysqli_fetch_field_direct() [name] or [orgname])取得结果中指定字段的字段名

mysql_error 替换 注：mysqli_error(conn) 参数必选mysql_errno 替换 注：mysqli_errno(conn) 参数必选mysql_numrows 替换 mysqli_num_rows

mysql_unbuffered_query 替换 mysqli_query (mysqli_query(“SQL语句”, MYSQLI_USE_RESULT);

)向 MySQL 发送一条 SQL 查询，并不获取和缓存结果的行

其他mysql函数，绝大部分都可以直接批量替换为mysqli相关函数，使用参考mysqli函数文档

mysql_affected_rows() 与 mysqli_affected_rows() 的区别

// MySQL方式 $query = "select * from td_user"; $cursor = exequery($conn, $query); $count0 = mysql_affected_rows(); var_dump($count0);

// MySQLI方式 $query = "select * from td_user"; $conn = TD::conn(); $cursor = exequery($conn, $query); $count1 = mysqli_num_rows($cursor); var_dump($count1); $count2 = mysqli_affected_rows($conn); var_dump($count2);

OA升级相关处理

1 建议使用pdo的SQL语法，medoo版本1.6 2 3 参考文档：https://medoo.lvtao.net/1.2/doc.php

数据库表修改

拆表：

user 改为 td_user

td_user表中的DEPT_ID_OTHER、USER_PRIV_OTHER 转存到user_other中，type=1辅助部门，

type=2辅助角色

department表中的1.部门主管,2:部门助理,3:上级主管领导,4:上级分管领导    转存到

department_manager表中

user_priv表中，角色对应的菜单FUNC_ID_STR，改成一对多存到user_priv_func user_ext表中U_FUNC_ID_STR 用户菜单ID串，改成一对多存到user_ext_func user_function表原来uid对应的user_func_id_str用户菜单id串，改为多条数据形式

注意：

建议非必要不要使用find_in_set函数，性能不好，优先使用    in

表结构字段建议设置为 NOT NULL DEFAULT ''

表属性：

1 表、字段编码均为 utf8_general_ci

数据库部分数据处理

unserialize 相关数据处理

由于之前gbk编码情况下存入数据库中的unserialize数据，在utf-8编码情况下解析后会变为空 处理方案： include_once("inc/utility_all.php"); $module_name = gbk2utf8_unserialize($module_name); // gbk数据转为utf8数据，后续该如何处理就如何处理即可

数据库兼容国产化相关处理

日期字段默认值 0000-00-00 判断改为 1000-01-01

时间字段默认值 0000-00-00 00:00:00 判断改为 1000-01-01 00:00:00

timestamp字段默认值 0000-00-00 00:00:00 判断改为 2000-01-01 00:00:00

配置文件说明

OA相关参数：

MYOA/webroot/inc/td_config.php

MYOA/webroot/inc/oa_config.php

MYOA_DB_TYPE （在db_config.php中设置，mysql dm kb st...） MYOA_PRODUCT_TYPE （0 - 标准版，1 - 信创版）

数据库配置：

MYOA/webroot/inc/db_config.php

//默认连接的数据库 $DB_TYPE = "mysql"; // ['mysql', 'dm', 'kb']

$MYSQL_SERVER = "127.0.0.1:3336"; $MYSQL_PORT = "3336"; // ['3336', '5236'] $MYSQL_USER = "oa"; $MYSQL_PASS = "myoa888"; $MYSQL_ROOT_USER = "root"; $MYSQL_ROOT_PASS = "myoa888"; $MYSQL_DB = "TD_OA"; $MYSQL_DB_APP = "TD_APP"; $MYSQL_DB_CRSCELL = "crscell"; $MYSQL_DB_ARCHIVE = "TD_OA_ARCHIVE";

Redis相关兼容

1 Redis::delete() 转为 Redis::del() 2 3 Redis::setTimeout() 转为 Redis::EXPIRE()

PHP新增函数接口

1  获取当前浏览器 inc/utility_all.php GetBrowser()

is_weakpass()

1  检验是否弱密码，true / false

GetMembersFromDept($DEPT_ID1, $QUERY_MASTER="")

1 获取指定主部门的成员user_id串信息

gbk2utf8_unserialize($str)

1 获取根据unserialize的gbk数据信息转为unserialize的utf-8数据信息

is_https()

1 获取当前访问是否是https请求，true / false

td_gzcompress($content, $db_type = 'mysql')

1 获取根据原始内容数据及数据库类型处理后的进制流数据

td_gzuncompress($compress_content, $db_type = 'mysql')

1    获取根据数据库中取出的进制流内容数据，针对不通数据库类型处理后的原始内容数据

1 获取我能管理的用户信息 2  [['uid' => 1, 'user_id' => 'admin', 'user_name' => '系统管理员'], ...]

inc/utility_org.php get_manage_user()

GetUserOtherAllByDeptId($DeptIds, $type=0, $return=0)

获取指定部门id串为主部门/辅助部门下的人员信息 return 1 - 用户user_id字符串信息 return 0 - 返回用户数组信息 4  [['uid' => 1, 'user_id' => 'admin'], ...]

GetUserOtherAllByUserPrivId($UserPrivId, $type=0, $retu

获取指定角色id串为主角色/辅助角色下的人员信息 return 1 - 用户user_id字符串信息 return 0 - 返回用户数组信息 4  [['uid' => 1, 'user_id' => 'admin'], ...]

GetUserOtherIdByUid($uid, $type=0)

获取指定用户uid的相关信息 type 1 - 辅助部门 type 2 - 辅助角色 type 0 - 辅助部门和辅助角色 5 ['dept_id_other' => '1,2,3,', 'user_priv_other' => '1,2,3,']

medoo相关及语法

medoo版本 1.6 webroot/inc/medoo/medoo.php

SQL实例select

$ret = TD::DB()->select(TD::tableFix("url"), "*", [

"OR"

=> [ "AND #first" "URL_TYPE" "USER" ], "AND #second" "URL_TYPE" "USER" ]

=> [ => '3', => ''

=> [ => '2', => $_SESSION["LOGIN_USER_ID"] ], "ORDER" => ["URL_NO" => "ASC"] ]); var_dump($ret); 输出结果： array(14) { [0]=> array(8) { ["URL_ID"]=> string(2) "23" ["URL_NO"]=> string(1) "1" ["URL_DESC"]=> string(12) "百度搜索" ["URL"]=> string(16) "http://baidu.com" ["USER"]=> string(0) "" ["URL_TYPE"]=> string(1) "3" ["SUB_TYPE"]=> string(0) "" ["URL_ICON"]=> string(13) "ewp_baidu.png" } [1]=> ... }

insert

1 TD::DB()->insert(TD::tableFix("im_offline_file"), ['TIME' => date('Y-m-d H:i:s'), 'SRC_UID' => $_SESSION["LOGIN_UID"], ...]); 2 TD::DB()->id();

update

1 TD::DB()->update(TD::tableFix("td_user"), ["ON_STATUS" => 1, ...], ["UID" => $_SESSION["LOGIN_UID"]]);

delete

1 TD::DB()->delete(TD::tableFix("address"),["ADD_ID" => $TOK]);

count

1 $TOTAL_ITEMS = TD::DB()->count(TD::tableFix('im_offline_file'),['DEST_UID' => $_SESSION["LOGIN_UID"]]);

prepareQuery

$query="select * from td_user ..."; $row = TD::DB()->prepareQuery($query);

debug

TD::DB()->debug()->select() TD::DB()->debug()->update() TD::DB()->debug()->insert() TD::DB()->debug()->prepareQuery() 5 ...

更多参考：中文文档-中文帮助手册-Medoo - 高效的轻量级PHP数据库框架, 提高开发效率！

存储： $compress_content = bin2hex(gzcompress($content)); $compress_content = '0x'.$compress_content;

获取： $compress_content

= gzuncompress($ret_test[0]['compress_content']);

富文本内容压缩存储

各数据库有关blob处理

MySQL blob处理

DM blob处理

存储： $compress_content = bin2hex(gzcompress($content));

// SQL中 '0x' 可加可不加，达梦会自动转十六进制 $compress_content = '0x'.$compress_content; 或者使用 TO_BLOB 函数处理 获取： $compress_content3 = @gzuncompress(hex2bin($ret_test[0] ['compress_content']));

KB blob处理

存储： $compress_content = bin2hex(gzcompress($content)); $compress_content = "x'".$compress_content."'";

获取： SELECT "COMPRESS_CONTENT"::BYTEA FROM "test_blob" WHERE id=1146;

medoo中CONTENT别名aa $ret_test = TD::DB()->select(TD::tableFix("test_blob"), ['CONTENT(aa)', 'COMPRESS_CONTENT'], array( "id" => $test_id 4 ));

业务代码使用

新增 & 修改

include_once("inc/utility_all.php"); $COMPRESS_CONTENT = td_gzcompress($CONTENT);

// 方法一：推荐 TD::DB()->insert('news', [ "COMPRESS_CONTENT[BLOB]" => $COMPRESS_CONTENT // 注：变量不需要使用引号处理 ]);

// 方法二： $query = "insert into news (`COMPRESS_CONTENT`) values ($COMPRESS_CONTENT);"; // 注：变量不需要使用引号处理exequery(TD::conn(), $query);

// 方法三： $query = "insert into news (`COMPRESS_CONTENT`) values ($COMPRESS_CONTENT);"; // 注：变量不需要使用引号处理TD::DB()->prepareQuery($query);

查看

include_once("inc/utility_all.php"); $COMPRESS_CONTENT = td_gzuncompress($ROW["COMPRESS_CONTENT"]);

归档数据库使用

方法一：直接ARCHIVE_DB连接数据库型 （推荐使用）

$table_name = "email_body_20190807"; $rows = TD::ARCHIVE_DB()->select($table_name, ['body_id', 'subject']);

方法二：DB函数重连数据库型

$table_name = "email_body_20190807"; $rows = TD::DB('1', true, 'td_oa_archive')->select($table_name, ['body_id', 'subject']); $table_name = "email_body_20190807"; $rows = TD::DB('1')->select($table_name, ['body_id', 'subject']);

方法三：复杂SQL型

$query = "select body_id,subject from td_oa_archive.email_body_20190807"; $rows = TD::DB()->prepareQuery($query);

方法四：mysqli连接数据库型

$query = "select body_id,subject from td_oa_archive.email_body_20190807"; $cursor = exequery(TD::conn(), $query); while($rows = mysqli_fetch_array($cursor))

方法五：medoo兼容处理型

$table_name = "td_oa_archive.email_body_20190807"; $rows = TD::DB()->select($table_name, ['body_id', 'subject']);

MySQL升级相关

配置文件my.ini修改

[mysql] default-character-set=utf8

[mysqld] character-set-server=utf8 skip-ssl # innodb_file_format=Barracuda log_timestamps = SYSTEM # thread_concurrency =8 sql_mode=NO_ENGINE_SUBSTITUTION

数据库管理工具配置

下载

官网下载phpMyAdmin工具：http://www.phpmyadmin.net，建议下载对应PHP版本的最新的all- language版本（准备工作文件已经给提供）

解压缩

在MYOA\webroot目录下新建一个目录，如mysql369(为了防止他人利用该工具侵入数据库系统，可把 目录名设为比较复杂的，如MySQL2345，避免目录名被猜测到。),将下载的程序包解压后拷贝至mysql369目录下

修改配置文件

用文本编辑器，如记事本，打开MySQL管理工具目录，复制config.sample.inc.php文件并改名为

confing.inc.php，打开后修改以下配置信息：

$cfg['blowfish_secret'] = ''; //随便输入一个字符串，加密Cookie等信息

$cfg['Servers'][$i]['auth_type'] = 'http'; //http,config,cookie，建议使用http

$cfg['Servers'][$i]['host'] = 'localhost'; //数据库地址，默认为localhost

$cfg['Servers'][$i]['port'] = '3336'; //数据库端口，默认为3336

$cfg['Servers'][$i]['user'] = 'root'; //数据库用户名，默认为root

$cfg['Servers'][$i]['password'] = ''; //数据库密码，默认为myoa888

技术支持 QQ2524837118

使用phpMyAdmin

MySQL管理工具地址：http://OA地址/mysql1369，注意，进入后先选择中文界面（中文-Chinese simplified ）。该管理工具的使用需具有一定数据库基础，请勿进行危险操作，以免导致数据丢失

注：也可使用其他的数据库管理工具，如Navicat等

MySQL升级遇到问题汇总

问题一：mysql5.7 BLOB, TEXT, GEOMETRY or JSON column 'user_str' can't have a default value select @@sql_mode 查看模式，修改模式为： sql_mode=NO_ENGINE_SUBSTITUTION //STRICT_TRANS_TABLES 存储引擎启用严格模式，非法数据值被拒绝