tp5 + laradock 从零搭建小程序后端问题总结

一、laradock首次up的时候，build过程非常慢

由于拉取容器的镜像默认在国外，所以在docker-compose up 容器之前，在.env文件中查找以下文字

CHANGE_SOURCE=false

然后将false改为true，并查找以下文字

#UBUNTU_SOURCE=aliyun

把前面的 # 去掉，即去掉注释，把默认在国外的镜像源改为国内速度快的aliyun的镜像源

然后把workspace的时区，改为中国时区，查找以下文字

WORKSPACE_TIMEZONE=UTC

把UTC改为PRC

然后执行命令

docker-compose up -d nginx mariadb

自己选择需要启动的容器

亲自对比过build的时间，在20M带宽下，不更改镜像源的话快则一小时，慢则一天，更改过后，仅需10min

二、laradock在启动容器 build workspace 的过程中报错

若出现相关文字 "raw.githubusercontent.com"，则在本地hosts绑定域名到ip

以linux为例

vim /etc/hosts

在文件中输入 "199.232.28.133 raw.githubusercontent.com" 即可

三、composer install 速度慢

安装完laradock在worksapce容器中从第三方托管仓库用git拉取tp5框架下来，composer install很慢，需要更换国内源，执行下面命令

composer config -g repo.packagist composer https://packagist.phpcomposer.com

四、composer忽略版本号安装

composer install 过程中遇到 Your requirements could not be resolved to an installable set of packages. 错误提示，则可以忽略版本号安装，执行下面命令

composer install --ignore-platform-reqs

五、composer安装tp5的数据库迁移工具

tp5.0的迁移工具是 1.*，tp5.1是 2.*，若不指定版本号，则默认安装最新的迁移工具，执行下面命令

composer require topthink/think-migration=1.*

六、laradock中tp5配置数据库连接时，host填写容器名字

我用的mariadb这个容器，所以如下配置

'host'=>'mariadb'

七、tp5给runtime全部权限

chmod -r runtime 777

八、tp5捕获mysql的抛出的异常

在catch的参数Exception前面加个反斜线，表示从最底层的Exception开始捕获

catch(\Exception)

九、做图片上传接口时，mkdir报错 no permission

为了引用图片方便，我把图片存储目录指定为 public/uploads ，但是报错了，可以通过给public全部权限解决

chmod -r public 777

十、后端接口的时候权限验证

oauth2时一个非常好的授权机制，php有一个很好的库 https://github.com/thephpleague/oauth2-server，但是很无奈，不像laravel有passport，也支持Drupal，cakephp等框架

使用Json-web-token也蛮好的 https://github.com/firebase/php-jwt

十一、跨域处理

在application目录下的tags.php中的添加应用初始化时执行的文件，例如我把跨域放在 applicationapi/behavior/CORS.php 文件中，在应用初始化过程中就发出header

    // 应用初始化
    'app_init'     => [
        'app\\api\\behavior\\CORS'
    ],

跨域文件

<?php
namespace app\api\behavior;
 
use think\Response;
 
class CORS
{
    public function appInit(&$params)
    {
        header('Access-Control-Allow-Origin: *');
        header("Access-Control-Allow-Headers: token,Origin, X-Requested-With, Content-Type, Accept");
        header("Access-Control-Allow-Methods:GET, POST");
        if (request()->isOptions()) {
            exit();
        }
    }
}

十二、git push/pull 需要验证身份，多次输入用户名和密码

linux环境中，在仓库目录下执行

git config --global credential.helper store

十三、git push 卡住

设置发包无边界，http的请求换缓冲区设置得大一些

git config --global sendpack.sideband false
git config --global http.postBuffer 524288000

十四、nginx不支持tp5的pathinfo

更改项目对应的 .conf 文件配置

location / {
         try_files $uri $uri/ /index.php$is_args$args;
         # 添加部分 ↓↓↓↓↓
         if (!-e $request_filename) {
                rewrite ^(.*)$ /index.php?s=$1 last;
                break;
         }
         # 添加部分 ↑↑↑↑↑
}

 # 更改前 location ~ \.php$ {
 location ~ \.php { 
        try_files $uri /index.php =404;
        fastcgi_pass php-upstream;
        fastcgi_index index.php;
        fastcgi_buffers 16 16k;
        fastcgi_buffer_size 32k;
        # 添加部分↓↓↓↓
        # Set var PATH_INFO
        fastcgi_split_path_info ^(.+\.php)(.*)$;
        fastcgi_param PATH_INFO $fastcgi_path_info;
        #  添加部分↑↑↑↑
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;   
        #fixes timeouts
        fastcgi_read_timeout 600;
        include fastcgi_params;
}

具体选项待我找时间学习一下

备注

众所周知，从github克隆一直比较慢，可以选择用码云，提前将常用的仓库导入到自己的码云工作空间，需要使用的时候通过码云克隆