配置

常用的配置参数会比较少，因为除非你有特别的定制，否则基本上默认值就可以了：

  1. use EasyWeChat\Factory;
  3. $config = [
  4.     'app_id' => 'wx3cf0f39249eb0exx',
  5.     'secret' => 'f1c242f4f28f735d4687abb469072axx',
  7.     // 指定 API 调用返回结果的类型：array(default)/collection/object/raw/自定义类名
  8.     'response_type' => 'array',
  10.     //...
  11. ];
  13. $app = Factory::officialAccount($config);

下面是一个完整的配置样例：

不建议你在配置的时候弄这么多，用到啥就配置啥才是最好的，因为大部分用默认值即可。

  1. <?php
  3. return [
  4.     /**
  5.      * 账号基本信息，请从微信公众平台/开放平台获取
  6.      */
  7.     'app_id'  => 'your-app-id',         // AppID
  8.     'secret'  => 'your-app-secret',     // AppSecret
  9.     'token'   => 'your-token',          // Token
  10.     'aes_key' => '',                    // EncodingAESKey，兼容与安全模式下请一定要填写！！！
  12.      /**
  13.       * 指定 API 调用返回结果的类型：array(default)/collection/object/raw/自定义类名
  14.       * 使用自定义类名时，构造函数将会接收一个 `EasyWeChat\Kernel\Http\Response` 实例
  15.       */
  16.     'response_type' => 'array',
  18.     /**
  19.      * 日志配置
  20.      *
  21.      * level: 日志级别, 可选为：
  22.      *         debug/info/notice/warning/error/critical/alert/emergency
  23.      * path：日志文件位置(绝对路径!!!)，要求可写权限
  24.      */
  25.     'log' => [
  26.         'default' => 'dev', // 默认使用的 channel，生产环境可以改为下面的 prod
  27.         'channels' => [
  28.             // 测试环境
  29.             'dev' => [
  30.                 'driver' => 'single',
  31.                 'path' => '/tmp/easywechat.log',
  32.                 'level' => 'debug',
  33.             ],
  34.             // 生产环境
  35.             'prod' => [
  36.                 'driver' => 'daily',
  37.                 'path' => '/tmp/easywechat.log',
  38.                 'level' => 'info',
  39.             ],
  40.         ],
  41.     ],
  43.     /**
  44.      * 接口请求相关配置，超时时间等，具体可用参数请参考：
  45.      * http://docs.guzzlephp.org/en/stable/request-config.html
  46.      *
  47.      * - retries: 重试次数，默认 1，指定当 http 请求失败时重试的次数。
  48.      * - retry_delay: 重试延迟间隔（单位：ms），默认 500
  49.      * - log_template: 指定 HTTP 日志模板，请参考：https://github.com/guzzle/guzzle/blob/master/src/MessageFormatter.php
  50.      */
  51.     'http' => [
  52.         'max_retries' => 1,
  53.         'retry_delay' => 500,
  54.         'timeout' => 5.0,
  55.         // 'base_uri' => 'https://api.weixin.qq.com/', // 如果你在国外想要覆盖默认的 url 的时候才使用，根据不同的模块配置不同的 uri
  56.     ],
  58.     /**
  59.      * OAuth 配置
  60.      *
  61.      * scopes：公众平台（snsapi_userinfo / snsapi_base），开放平台：snsapi_login
  62.      * callback：OAuth授权完成后的回调页地址
  63.      */
  64.     'oauth' => [
  65.         'scopes'   => ['snsapi_userinfo'],
  66.         'callback' => '/examples/oauth_callback.php',
  67.     ],
  68. ];

:heart: 安全模式下请一定要填写 aes_key

日志配置

日志有两种配置方式：

文件式

  1. 'log' => [
  2.     'level'      => 'debug',
  3.     'permission' => 0777,
  4.     'file'       => '/tmp/easywechat.log',
  5. ],

配置文件里的 /tmp/... 是绝对路径

如果在 windows 平台，需要把它改成 C:\foo\bar 的形式，

如果需要按日独立存储，可以配置成 'file' => storage_path('/tmp/easywechat/easywechat_'.date('Ymd').'.log'),

自定义 Handler

由于日志使用的是 Monolog，所以，除了默认的文件式日志外，你可以自定义日志处理器：

  1. use Monolog\Handler\RotatingFileHandler;
  3. $handler = new RotatingFileHandler('/path/to/wechat.log', 5, 'debug');
  5. ...
  7. 'log' => [
  8.     'level'   => 'debug',
  9.     'handler' => $handler,
  10. ],