钉钉开发文档

PHP版QuickStart

更新时间: 2019-6-3

本quick start为企业自建应用接入钉钉示例,用于满足开发者20分钟快速体验钉钉开发。在此demo中,您会利用免登功能获取到用户信息。
服务端语言为PHP,您要具备PHP开发环境以及APACHE或者Nginx服务器环境。

1.创建应用

参考创建应用小节了解如何在钉钉开发者后台创建应用。

2.服务端开发

下载服务端代码

git clone https://github.com/opendingtalk/eapp-corp-quick-start-php.git

导入服务端代码并修改配置

更改服务端php代码config.php文件

/**
     * 开发者后台->企业自建应用->选择您创建的应用->查看->AppKey
     */
    define("APP_KEY", "");
    /**
     * 开发者后台->企业自建应用->选择您创建的应用->查看->AppSecret
     */
    define("APP_SECRET", "");

所需要的参数可通过如下方式获取:
在开发者后台中点击您创建的企业自建应用,可进入应用详情页面。如下图所示:
image.png

image.png
再点击"查看详情",可以获取应用的appKey和appSecret。
image.png

启动服务端程序

配置好php的环境,并将php服务端代码放入apache或者nginx容器下即可运行。

检查启动成功页面

检查服务端启动成功页面。
访问 http://localhost/index.php 地址,打开页面如下图所示,


3.前端开发

下载前端代码

git clone https://github.com/opendingtalk/eapp-corp-quick-start-fe.git

下载IDE并导入前端代码

小程序IDE开发工具,下载链接
打开小程序前端IDE,打开项目,选择项目路径,设置项目类型为企业内部应用。


修改前端配置

修改文件eapp-corp-quick-start-fe/page/index/index.js。
IP端口为本机的IP和PORT,注意url中的IP或者域名必须是开发者后台台中设置的本应用的安全域名。

小程序前端发起网络请求时是直连安全域名或IP的,因此假如您的前端demo和服务端demo都在一个办公环境内(比如都在您的PC电脑上),是可以直接互通的,因此可以设置任何您的前端所在环境能连接到的域名或IP为安全域名。
您也可以通过钉钉提供的内网穿透工具生成一个临时二级域名设置为安全域名,用于测试应用。

//替换成开发者后台设置的安全域名
let domain = "http://********";
// php替换成login地址
let url = domain + '/login.php';

模拟器体验

完成上述域名修改,扫码登陆后,选择关联应用与服务端设置小程序一致,可以直接使用IDE进行模拟器体验,如下图所示:

上传版本

点击上传按钮进行版本上传。

祝贺您已经成功体验本QuickStart。

以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!