1、在application的目录下建立common文件夹，那么在tp中有进行处理过，是不能被访问的，那么在common文件夹下，可以建立些公用的方法或者基类
2、系统提供了专门的标签来简化上面的导入
{load href="/static/js/common.js" /} {load href="/static/css/style.css" /} <!--也可以同时引入多个--> {load href="/static/js/common.js,/static/css/style.css" /} <!--系统还提供了两个标签别名js和css 用法和load一致，例如：--> {js href="/static/js/common.js" /} {css href="/static/css/style.css" /}
3、在使用{:url(\'index/index\')}的时候可以不填写模块，因为系统在哪个模块下面，那么路由会被自动定位到对应的模块下面
4、thinkphp5中，使用validate进行较验的时候，如果需要知道多个较验证效果，那么可以使用batch这个接口如下：
public function add() { $param = request()->post(); $v = validate(\'AdminUser\')->scene(\'add\'); if(!$v->batch()->check($param)) { dump($v->getError()); } else { dump(\'ok\'); } }
5、thinkphp5 提供了一个抛出异常的方法exception(\'...\')来抛出异常
6、自定义配置，可以在application下新建一个目录extra，再在下面新建配置文件，如:captcha.php，那么访问需要用config(\'captcha.width\')的方式进行访问。
7、ajax请求可以用controller里面自动定义的方法$this->result()进行返回。如果需要自定义的情况，那么可以自动return [...]的方式即可。
8、上传文件进行检测时可以采用以下方法
$file = request()->file(\'file\'); $file->check([ \'type\' => \'image/jpg,image/png,image/jpeg\', \'size\' => 2097152, \'ext\' => \'png,jpg\' ]); halt($file->getError()); //注意以下逗号之间是不能的空隔的
也可以使用validate
$file = request()->file(\'file\'); $res = $file->validate([ \'type\' => \'image/jpg,image/png,image/jpeg\', \'ext\' => \'png,jpg\', \'size\' => \'fileSize:2097152\' ]); dump($res->check()); halt($res->getError());
也可以使用单独的方法，如下
$file = request()->file(\'file\'); $res = $file->checkMime([\'image/png\', \'image/jpeg\',\'image/png\']); dump($res);
9、文件上传示例
public function uploadData() { $file = request()->file(\'file\'); $rule = $file->checkMime([\'image/jpeg\', \'image/jpg\', \'image/png\']); if($rule) { $res = $file->move(\'upload\'); $this->result([\'path\' => $res->getPathname()], 200, \'上传成功\'); } else { $this->result([], 500, \'类型有误\'); } }
10、文件上传至七牛云方法
// 引入鉴权类 use Qiniu\Auth; // 引入上传类 use Qiniu\Storage\UploadManager; // 需要填写你的 Access Key 和 Secret Key $accessKey ="your accessKey"; $secretKey = "your secretKey" $bucket = "your bucket name"; // 构建鉴权对象 $auth = new Auth($accessKey, $secretKey); // 生成上传 Token $token = $auth->uploadToken($bucket); // 要上传文件的本地路径 $filePath = \'./php-logo.png\'; // 上传到七牛后保存的文件名 $key = \'my-php-logo.png\'; // 初始化 UploadManager 对象并进行文件的上传。 $uploadMgr = new UploadManager(); // 调用 UploadManager 的 putFile 方法进行文件的上传。 list($ret, $err) = $uploadMgr->putFile($token, $key, $filePath); echo "\n====> putFile result: \n"; if ($err !== null) { var_dump($err); } else { var_dump($ret); }
封装七牛云的sdk
<?php namespace app\common\utils; use Qiniu\Auth; use Qiniu\Storage\UploadManager; class Upload{ public static function imgUpload($name) { $file = request()->file($name)->getInfo(); if(!empty($file)) { $key = self::getNewName(pathinfo($file[\'name\'], PATHINFO_EXTENSION)); $upload = new UploadManager(); list($ret, $err) = $upload->putFile(self::getToken(), $key, $file[\'tmp_name\']); if($err !== null) { return null; } else { return $ret[\'key\']; } } return null; } /**获取 token * @return string */ private static function getToken() { $auto = new Auth(config(\'qiniu.ak\'), config(\'qiniu.sk\')); return $auto->uploadToken(config(\'qiniu.bucket\')); } /**生成新的名字 * @param $ext * @return string */ private static function getNewName($ext) { return date(\'Ymd\').uniqId(config(\'qiniu.prefix\')).\'.\'.$ext; } }
注意：如果需要下载七牛云上的资源可以使用
http://<domain>/<key>?attname=<file_name> //如 http://www.baidu.com/abc.jpg?attname=a.jpg
具体可以参考 https://developer.qiniu.com/kodo/manual/1659/download-setting
11、在使用try{}catch(\Exception $e) {}当中尽可能的不用$this->result();但这个可以在外面使用或者在异常处使用，否则容易出错如下
public function submitData() { $data = request()->post(); $v = validate(\'News\'); if(!$v->check($data)) { $this->result([], 300, $v->getError()); } else { try{ $data[\'create_time\'] = $data[\'update_time\'] = request()->server(\'REQUEST_TIME\'); model(\'News\')->allowField(true)->save($data); }catch(\Exception $e) { $this->result([\'msg\' => $e->getMessage(), \'code\' => $e->getCode()], 300, $e->getMessage()); } $this->result([], 200, \'操作成功\'); } }
12、在application下面的common.php中定义方法，那么在tp类中是可以正常调用到的
<?php // 应用公共文件 function getMsg() { return \'are you ok???\'; }
13、在application下面有一个json()方法，可以返回前端ajax请求的状态码(status)以及对应的数据data,如下：
public function index() { return json([ \'name\' => \'abc\', \'age\' => 30, ], 201); }
14、thinkphp5不可预知的内部异常的处理解决办法
方法一：更改错误信息的渲染方式（主要是针对系统内容的错误）
a、定义一个错误处理类，并且继承TP5里的handle方法，重写里面的render方法，如下：
<?php namespace app\common\utils; use Exception; use think\exception\Handle; class ApiExceptionHandle extends Handle{ private $code = 500; public function render(Exception $e) { $data = [ \'code\' => 1, \'msg\' => config(\'app_debug\')? $e->getMessage(): \'服务器错误\', \'data\' => [] ]; return json($data, $this->code); } }
b、在application中的config.php中配置异常的处理方法，如下
方法二、手动抛出错误的（主要针对开发过程中，抛出的异常，前提是建立在方法一上，进行修改）
a、添加一个手动抛出异常的类
<?php namespace app\common\utils; use think\Exception; use Throwable; class ApiException extends Exception { public $a_code; public $a_message; public $a_data; public $a_status; public function __construct($message = "", $code = 0, Throwable $previous = null, $data = [], $status = 500) { parent::__construct($message, $code, $previous); $this->a_code = $code; //自定义的里面的code $this->a_message = $message; //自定义的data里的message $this->a_data = $data; //自定义的data数据 $this->a_status = $status; //自定义的status状态码 } }
b、对原有的ApiExceptionHandle 类进行修改
<?php namespace app\common\utils; use Exception; use think\exception\Handle; class ApiExceptionHandle extends Handle{ private $code = 500; public function render(Exception $e) { if(!config(\'app_debug\')) { //是否开启debug if($e instanceof ApiException) { //如果是自定义的抛出异常，那么就使用自定义的status以及其他参数 $this->code = $e->a_status; //覆盖原有的$code $data = [\'code\' => $e->a_code, \'msg\' => $e->a_message, \'data\' => $e->a_data]; //调用ApiException中定义的参数 } else { $data = [\'code\' => 1, \'msg\' => \'服务器错误\', \'data\' => []]; } return json($data, $this->code); //返回AJAX请求 } return parent::render($e); } }
c、可以在application下的common.php中封装一个调用的方法（例子无）以方便调用
d、调用例子如下：
class Test extends Controller { public function index() { throw new ApiException(\'are you ok???\', 300, null, [\'a\' => \'aaaa\'],404); }
15、多级控制器的使用以及路由的配置
namespace app\index\controller\one; use think\Controller; class Blog extends Controller { public function index() { return $this->fetch(); } public function add() { return $this->fetch(); } public function edit($id) { return $this->fetch(); } } //访问地址如下 http://serverName/index.php/index/one.blog/index //可以进行如下的路由配置 \think\Route::get(\'blog/add\',\'index/one.Blog/add\');
16、对于一些不能通过composer来安装的sdk,那么可以安装到thinkphp5下的extend目录下，做为一个扩展使用
注意：在安装的时候，要填对namespace，否则会访问不到相关的类
a、如 在extend下的一个lib目录安装一个test 类，那么它的namespace路径则需要写作 namespace lib, 如果在lib下还有一个文件夹a 下面才是test, 那么namespace为： namespace lib\a；
b、安装sdk的时候注意如果没有命名空间的话，那么需要添加上对应的命名空间
17、在做接口的时候，较验的时候，model或其他非controller模块，尽可能返回完整的数据信息，这样以避免controller再去适配ajax的返回json数据，如下示例（以下可进行进一步封装）
/**发送短信 * @param $phone * @return array|bool * @throws \Exception */ public static function sendLoginMsg($phone) { $code = mt_rand(1000, 9999); $res = self::checkStatus($phone); if($res === true) { $res = SendMsg::getInstance()->send($phone, [$code, config(\'sms.expire\')/60]); if($res[\'res\'] === 0) { self::saveStatus($phone, $code); return [\'code\' => 0, \'msg\' => \'发送成功\', \'data\' => []]; //可以将数据封装成一个方法 } else { Log::write(\'发送信息失败\'.json_encode($res)); return [\'code\' => 1, \'msg\' => $res[\'msg\'], \'data\' => []]; } } return $res; }