linux + 宝塔 + thinkphp5.0 搭建后端api各种问题集合-白红宇的个人博客

发布日期：2021-05-09 00:33:16 浏览次数：19 分类：博客文章

本文共 15716 字，大约阅读时间需要 52 分钟。

安装宝塔

官方地址：

我用的centos 7 所以有以下指令

yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh

安装完毕，记下我们服务器的宝塔账号和密码

然后登陆宝塔，在软件商店中安装nginx + php，我用的云数据库，所以没有安装mysql

然后我们去安装thinkphp 5，官方地址：

Composer安装

curl -sS https://getcomposer.org/installer | phpmv composer.phar /usr/local/bin/composer

用composer安装别忘了更改镜像源，国内镜像源比较快

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

然后到web根目录下去执行

composer create-project topthink/think=5.0.* tp5  --prefer-dist

compser过程中putenv、proc_open被禁用和版本报错

去宝塔的软件商店设置一下php禁用函数

找到putenv然后删除

同理，解除proc_open禁用

版本报错

替换镜像源即可

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

php启动服务过程中passthru被禁用

在宝塔中解除禁用即可

Git安装

亲测，码云的这个已经不能用了

直接用github的，稍微慢一点

git clone https://github.com/top-think/think tp5git clone https://github.com/top-think/framework thinkphp

然后进入thinkphp目录，切换核心库到master分支

cd thinkphpgit checkout mastergit pull https://github.com/top-think/framework

上述步骤结束，tp5就安装完成了，然后我们去宝塔配置下nginx

到网站选项添加站点

点设置打开配置文件

在51行添加以下代码来支持tp的pathinfo

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

如果有证书的话，下载下来配置ssl

然后去网站目录更改运行目录为框架低下的public目录

至此宝塔这部分结束

tp5在linux下的权限问题

进入主目录，将runtime目录设置为777，注意-R一定是大写的R，不然无法执行

chmod -R 777 runtime/

然后将public目录设置为755，如果运行有问题，则将其设置为755

chmod -R 755 public/

没有意外情况出现的话，tp5可以正常运行

如果还运行不了，将整个工程设置为777，然后重复上述两步

数据库配置

tp5支持解析带端口号的数据库地址

根据实际情况配置，单一库或者主从库


    // +----------------------------------------------------------------------return [    // 数据库类型    'type'            => 'mysql',    // 服务器地址    'hostname'        => 'bj-cdb-nivnaury.sql.tencentcdb.com:60991',    // 数据库名    'database'        => 'lianmai',    // 用户名    'username'        => 'username',    // 密码    'password'        => 'password',    // 端口    'hostport'        => '60991',    // 连接dsn    'dsn'             => '',    // 数据库连接参数    'params'          => [],    // 数据库编码默认采用utf8    'charset'         => 'utf8',    // 数据库表前缀    'prefix'          => '',    // 数据库调试模式    'debug'           => true,    // 数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器)    'deploy'          => 0,    // 数据库读写是否分离 主从式有效    'rw_separate'     => true,    // 读写分离后 主服务器数量    'master_num'      => 1,    // 指定从服务器序号    'slave_no'        => '',    // 自动读取主库数据    'read_master'     => false,    // 是否严格检查字段是否存在    'fields_strict'   => true,    // 数据集返回类型    'resultset_type'  => 'array',    // 自动写入时间戳字段    'auto_timestamp'  => false,    // 时间字段取出后的默认时间格式    'datetime_format' => 'Y-m-d H:i:s',    // 是否需要进行SQL性能分析    'sql_explain'     => false,    //'unix_socket' => '/var/run/mysqld/mysqld.sock'];

数据迁移工具Migration

跨域处理

在应用生命周期的开头注册下面的跨域类

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, OPTIONS, DELETE");        if (request()->isOptions()) {            exit();        }    }}

tp5.0应用生命周期

tags.php


    // +----------------------------------------------------------------------// 应用行为扩展定义文件return [    // 应用初始化    'app_init'     => [        'app\\api\\behavior\\CORS'    ],    // 应用开始    'app_begin'    => [],    // 模块初始化    'module_init'  => [],    // 操作开始执行    'action_begin' => [],    // 视图内容过滤    'view_filter'  => [],    // 日志写入    'log_write'    => [],    // 应用结束    'app_end'      => [],];

Jwt的使用

github地址：

composer安装

composer require lcobucci/jwt

然后写令牌


    setIssuer('https://sqadmin.dao-tech.com')                ->setAudience('https://sqadmin.dao-tech.com')                ->setId($uid . $user_name, true) //自定义标识                ->setIssuedAt(time())                 ->setExpiration(time() + (86400 * 30)) //token有效期时长                ->set('uid', $uid)                ->sign($signer, 'llwhappyeveryday')                ->getToken();            return (String) $token;          }            // 验证jwt    public static function check($token, $uid, $user_name)     {        $token = (new Parser())->parse((String) $token);        $signer =  new Sha256();        if (!$token->verify($signer, 'llwhappyeveryday')) {            return false; //签名不正确        }        $validationData = new ValidationData();        $validationData->setIssuer('https://sqadmin.dao-tech.com');        $validationData->setAudience('https://sqadmin.dao-tech.com');        $validationData->setId($uid . $user_name);//自定义标识        return $token->validate($validationData);    }}

应用配置 config.php

常用的配置

应用模式

路由缓存

pathinfo配置

分页

session和cookie

自定义的全局变量


    // +----------------------------------------------------------------------return [    // +----------------------------------------------------------------------    // | 应用设置    // +----------------------------------------------------------------------    // 应用调试模式    'app_debug'              => true,    // 应用Trace    'app_trace'              => false,    // 应用模式状态    'app_status'             => '',    // 是否支持多模块    'app_multi_module'       => true,    // 入口自动绑定模块    'auto_bind_module'       => false,    // 注册的根命名空间    'root_namespace'         => [],    // 扩展函数文件    'extra_file_list'        => [THINK_PATH . 'helper' . EXT],    // 默认输出类型    'default_return_type'    => 'html',    // 默认AJAX 数据返回格式,可选json xml ...    'default_ajax_return'    => 'json',    // 默认JSONP格式返回的处理方法    'default_jsonp_handler'  => 'jsonpReturn',    // 默认JSONP处理方法    'var_jsonp_handler'      => 'callback',    // 默认时区    'default_timezone'       => 'PRC',    // 是否开启多语言    'lang_switch_on'         => false,    // 默认全局过滤方法 用逗号分隔多个    'default_filter'         => '',    // 默认语言    'default_lang'           => 'zh-cn',    // 应用类库后缀    'class_suffix'           => false,    // 控制器类后缀    'controller_suffix'      => false,    // +----------------------------------------------------------------------    // | 模块设置    // +----------------------------------------------------------------------    // 默认模块名    'default_module'         => 'index',    // 禁止访问模块    'deny_module_list'       => ['common'],    // 默认控制器名    'default_controller'     => 'Index',    // 默认操作名    'default_action'         => 'index',    // 默认验证器    'default_validate'       => '',    // 默认的空控制器名    'empty_controller'       => 'Error',    // 操作方法后缀    'action_suffix'          => '',    // 自动搜索控制器    'controller_auto_search' => false,    // +----------------------------------------------------------------------    // | URL设置    // +----------------------------------------------------------------------    // PATHINFO变量名 用于兼容模式    'var_pathinfo'           => 's',    // 兼容PATH_INFO获取    'pathinfo_fetch'         => ['ORIG_PATH_INFO', 'REDIRECT_PATH_INFO', 'REDIRECT_URL'],    // pathinfo分隔符    'pathinfo_depr'          => '/',    // URL伪静态后缀    'url_html_suffix'        => 'html|json|xml',    // URL普通方式参数 用于自动生成    'url_common_param'       => false,    // URL参数方式 0 按名称成对解析 1 按顺序解析    'url_param_type'         => 0,    // 是否开启路由    'url_route_on'           => true,    // 路由使用完整匹配    'route_complete_match'   => false,    // 路由配置文件（支持配置多个）    'route_config_file'      => ['route'],    // 是否开启路由解析缓存    'route_check_cache'      => false,    // 是否强制使用路由    'url_route_must'         => true,    // 域名部署    'url_domain_deploy'      => false,    // 域名根，如thinkphp.cn    'url_domain_root'        => '',    // 是否自动转换URL中的控制器和操作名    'url_convert'            => true,    // 默认的访问控制器层    'url_controller_layer'   => 'controller',    // 表单请求类型伪装变量    'var_method'             => '_method',    // 表单ajax伪装变量    'var_ajax'               => '_ajax',    // 表单pjax伪装变量    'var_pjax'               => '_pjax',    // 是否开启请求缓存 true自动缓存 支持设置请求缓存规则    'request_cache'          => false,    // 请求缓存有效期    'request_cache_expire'   => null,    // 全局请求缓存排除规则    'request_cache_except'   => [],    // +----------------------------------------------------------------------    // | 模板设置    // +----------------------------------------------------------------------    'template'               => [        // 模板引擎类型 支持 php think 支持扩展        'type'         => 'Think',        // 默认模板渲染规则 1 解析为小写+下划线 2 全部转换小写        'auto_rule'    => 1,        // 模板路径        'view_path'    => '',        // 模板后缀        'view_suffix'  => 'html',        // 模板文件名分隔符        'view_depr'    => DS,        // 模板引擎普通标签开始标记        'tpl_begin'    => '{',        // 模板引擎普通标签结束标记        'tpl_end'      => '}',        // 标签库标签开始标记        'taglib_begin' => '{',        // 标签库标签结束标记        'taglib_end'   => '}',    ],    // 视图输出字符串内容替换    'view_replace_str'       => [],    // 默认跳转页面对应的模板文件    'dispatch_success_tmpl'  => THINK_PATH . 'tpl' . DS . 'dispatch_jump.tpl',    'dispatch_error_tmpl'    => THINK_PATH . 'tpl' . DS . 'dispatch_jump.tpl',    // +----------------------------------------------------------------------    // | 异常及错误设置    // +----------------------------------------------------------------------    // 异常页面的模板文件    'exception_tmpl'         => THINK_PATH . 'tpl' . DS . 'think_exception.tpl',    // 错误显示信息,非调试模式有效    'error_message'          => '页面错误！请稍后再试～',    // 显示错误信息    'show_error_msg'         => false,    // 异常处理handle类 留空使用 \think\exception\Handle    'exception_handle'       => '',    // +----------------------------------------------------------------------    // | 日志设置    // +----------------------------------------------------------------------    'log'                    => [        // 日志记录方式，内置 file socket 支持扩展        'type'  => 'File',        // 日志保存目录        'path'  => LOG_PATH,        // 日志记录级别        'level' => [],    ],    // +----------------------------------------------------------------------    // | Trace设置 开启 app_trace 后 有效    // +----------------------------------------------------------------------    'trace'                  => [        // 内置Html Console 支持扩展        'type' => 'Html',    ],    // +----------------------------------------------------------------------    // | 缓存设置    // +----------------------------------------------------------------------    'cache'                  => [        // 驱动方式        'type'   => 'File',        // 缓存保存目录        'path'   => CACHE_PATH,        // 缓存前缀        'prefix' => '',        // 缓存有效期 0表示永久缓存        'expire' => 0,    ],    // +----------------------------------------------------------------------    // | 会话设置    // +----------------------------------------------------------------------    'session'                => [        'id'             => '',        // SESSION_ID的提交变量,解决flash上传跨域        'var_session_id' => '',        // SESSION 前缀        'prefix'         => 'think',        // 驱动方式 支持redis memcache memcached        'type'           => '',        // 是否自动开启 SESSION        'auto_start'     => true,    ],    // +----------------------------------------------------------------------    // | Cookie设置    // +----------------------------------------------------------------------    'cookie'                 => [        // cookie 名称前缀        'prefix'    => '',        // cookie 保存时间        'expire'    => 0,        // cookie 保存路径        'path'      => '/',        // cookie 有效域名        'domain'    => '',        //  cookie 启用安全传输        'secure'    => false,        // httponly设置        'httponly'  => '',        // 是否使用 setcookie        'setcookie' => true,    ],    //分页配置    'paginate'               => [        'type'      => 'bootstrap',        'var_page'  => 'page',        'list_rows' => 15,    ],    // 小程序信息設置    'wxapp' => [        'appid' =>'',        'appsecret'=>''    ],    'aliyun_access'=>[        'accessKeyID'=>'',        'accessKeySecret'=>''    ]];

路由配置

定义路由

use think\Route;// 注册路由到index模块的News控制器的read操作Route::rule('new/:id','index/News/read');

带提交方式

Route::rule('new/:id','News/update','POST');

直接使用提交方式的函数

Route::get('new/:id','News/read'); // 定义GET请求路由规则Route::post('new/:id','News/update'); // 定义POST请求路由规则Route::put('new/:id','News/update'); // 定义PUT请求路由规则Route::delete('new/:id','News/delete'); // 定义DELETE请求路由规则Route::any('new/:id','News/read'); // 所有请求都支持的路由规则

同一个请求，多种提交方式

Route::rule('new/:id','News/read','GET|POST');

使用数组批量添加路由

Route::rule([    'new/:id'  =>  'News/read',    'blog/:id' =>  ['Blog/update',['ext'=>'shtml'],['id'=>'\d{4}']],    ...],'','GET',['ext'=>'html'],['id'=>'\d+']);

变量规则

全局变量

// 设置name变量规则（采用正则定义）Route::pattern('name','\w+');// 支持批量添加Route::pattern([    'name'  =>  '\w+',    'id'    =>  '\d+',]);

局部变量

// 定义GET请求路由规则 并设置name变量规则Route::get('new/:name','News/read',[],['name'=>'\w+']);

完整url规则

// 定义GET请求路由规则 并设置完整URL变量规则Route::get('new/:id','News/read',[],['__url__'=>'new\/\w+$']);

路由参数

method	请求类型检测，支持多个请求类型
ext	URL后缀检测，支持匹配多个后缀
deny_ext	URL禁止后缀检测，支持匹配多个后缀
https	检测是否https请求
domain	域名检测
before_behavior	前置行为（检测）
after_behavior	后置行为（执行）
callback	自定义检测方法
merge_extra_vars	合并额外参数
bind_model	绑定模型（`V5.0.1+`）
cache	请求缓存（`V5.0.1+`）
param_depr	路由参数分隔符（`V5.0.2+`）
ajax	Ajax检测（`V5.0.2+`）
pjax	Pjax检测（`V5.0.2+`）

路由地址定义

方式1：路由到模块/控制器	'[模块/控制器/操作]?额外参数1=值1&额外参数2=值2...'
方式2：路由到重定向地址	'外部地址'（默认301重定向）或者 ['外部地址','重定向代码']
方式3：路由到控制器的方法	'@[模块/控制器/]操作'
方式4：路由到类的方法	'\完整的命名空间类::静态方法' 或者 '\完整的命名空间类@动态方法'
方式5：路由到闭包函数	闭包函数定义（支持参数传入）

可以用路由到控制器方法，这种不用二次解析路由

'blog/:id'=>'@index/blog/read'

系统会直接执行

Loader::action('index/blog/read');

路由到类方法

'blog/:id'=>'\app\index\service\Blog@read'

重定向地址使用动态变量即可

'blog/:id'=>'http://blog.thinkphp.cn/read/:id'

路由别名

// user 别名路由到 index/User 控制器Route::alias('user','index/User');

在route.php种定义

return [    '__alias__' =>  [        'user'  =>  'index/User',    ],];

路由别名可以指向任意一个有效的路由地址，例如下面指向一个类

// user 路由别名指向 User控制器类Route::alias('user','\app\index\controller\User');

路由别名设置路由条件

// user 别名路由到 index/user 控制器Route::alias('user','index/user',['ext'=>'html']);

在route.php中配置

return [    '__alias__' =>  [        'user'  =>  ['index/user',['ext'=>'html']],    ],];

操作方法黑白名单

路由别名的操作方法支持白名单或者黑名单机制，例如：

// user 别名路由到 index/user 控制器Route::alias('user','index/user',[    'ext'=>'html'，    'allow'=>'index,read,edit,delete',]);

或者使用黑名单机制

// user 别名路由到 index/user 控制器Route::alias('user','index/user',[    'ext'=>'html'，    'except'=>'save,delete',]);

并且支持设置操作方法的请求类型，例如：

// user 别名路由到 index/user 控制器Route::alias('user','index/user',[    'ext'=>'html'，    'allow'=>'index,save,delete',    'method'=>['index'=>'GET','save'=>'POST','delete'=>'DELETE'],]);

路由分组

'blog/:id'   => ['Blog/read', ['method' => 'get'], ['id' => '\d+']],'blog/:name' => ['Blog/read', ['method' => 'post']],

可以合并到一个blog分组

'[blog]'     => [    ':id'   => ['Blog/read', ['method' => 'get'], ['id' => '\d+']],    ':name' => ['Blog/read', ['method' => 'post']],],

可以使用Group类的group方法

Route::group('blog',[    ':id'   => ['Blog/read', ['method' => 'get'], ['id' => '\d+']],    ':name' => ['Blog/read', ['method' => 'post']],]);

路由分组支持嵌套

Route::group(['method'=>'get','ext'=>'html'],function(){    Route::group('blog',function(){        Route::any('blog/:id','blog/read',[],['id'=>'\d+']);        Route::any('blog/:name','blog/read',[],['name'=>'\w+']);    }});

全部miss路由

return [    'new/:id'   => 'News/read',    'blog/:id'  => ['Blog/update',['method' => 'post|put'], ['id' => '\d+']],    '__miss__'  => 'public/miss',];

也可以使用miss方法

Route::miss('public/miss');

分组miss路由

return [    '[blog]' =>  [        'edit/:id'  => ['Blog/edit',['method' => 'get'], ['id' => '\d+']],        ':id'       => ['Blog/read',['method' => 'get'], ['id' => '\d+']],        '__miss__'  => 'blog/miss',    ],    'new/:id'   => 'News/read',    '__miss__'  => 'public/miss',];

在group方法中嵌套miss方法

Route::group('blog',function(){    Route::rule(':id','blog/read',[],['id'=>'\d+']);    Route::rule(':name','blog/read',[],['name'=>'\w+']);    Route::miss('blog/miss');},['method'=>'get','ext'=>'html']);

路由闭包函数

Route::get('hello/:name',function($name){     return 'Hello,'.$name;});

上一篇：Git介绍

下一篇：SpringBoot接口文件findBy方法写错导致抛出IllegalArgumentException

发表评论

关于作者

喝酒易醉，品茶养心，人生如梦，品茶悟道，何以解忧？唯有杜康！

-- 愿君每日到此一游！