PHP中的框架众多,我自己就接触了好几个。大学那会啥也不懂啥也不会,拿了一个ThinkPHP学了。也许有好多人吐槽TP,但是个人感觉不能说哪个框架好,哪个框架不好,再不好的框架你能把源码读上一遍,框架的设计思想理解了也能学到好多东西。况且有好多东西自己还不理解,所以认真学习一个框架这还是可以学不少东西的。
还是先说说Laravel吧,现在已经到5.2了。就我自己来说之前没有接触过laravel,但是学习过laravel之后感觉这个框架确实不错,并且老外用的不亦乐乎。他的开发社区还可以,文档比较齐全,但是官网文档不咋地,从上面读不出多少东西(自己感觉),好多东西还得阅读源码,对于我这种英语不好的人还更喜欢中文文档(以后得改)。Laravel是使用Composer(https://getcomposer.org)来管理依赖,确实比较方便,但是因为镜像被墙的原因在访问或者更新的时候比较慢(几乎失败),这里有解决办法:http://pkg.phpcomposer.com/#tip1。
最近因为工作需要项目要重构(重构原因不用多说,大家懂得),需要迁移到新的框架上。Laravel是一个不错的框架,强大的路由,便捷的配置,高可用的模块依赖,确实为开发省了不少力气。考虑到我们这个项目主要是接口部分,对性能有一定的要求(但是不是苛刻),并且路由不能改,要兼容老的逻辑,所以Laravel是首选,但是有一个问题就是我们是写接口,那么要依赖的东西就少很多,比如view层几乎用不到,还有就是测试模块,上传模块(有图床),本地化模块文件系统等也用不到,所以使用Laravel还是比较浪费的,说白了他比较重。所以我们就考虑了基于laravel的一个框架Lumen,相比Laravel这个全栈框架而言Lumen精简了不少,并且Lumen是面向Api的,所以最后就选择Lumen了。
laravel也不是全能的有优点也有缺点,比如他的依赖太多,可以看一下安装好的laravel框架默认的依赖源包就有30M左右,确实有点大。直到今天在使用过程中发现Lumen也是有点力不从心,随着业务逻辑越来越复杂,访问速度各方面也下来了,我们有时候考虑 slim 等更轻量级的,其实吧新浪这边不少人是鸟哥粉,不少人推崇yaf,yaf确实牛逼,实践证明快的不止一点两点,估计以后还得迁移到yaf。这段时间PHP7不是出了吗,但是测试结果表明Bug不少,把接口迁移到7上应该有不少的性能提升,据说是提高100%,还没敢尝试,等稳定了再说吧!
说了不少废话,下面我就介绍一下Laravel中的日志与上传,慢慢来,这篇文章先写一部分,因为Laravel东西比较多,其他的我会慢慢写出来。我就说说自己在使用过程中遇到的问题,遇到的坑,帮助大家学习。
一、日志
1、说明:
日志重要性不言而喻,我们这边的日志是人工推荐,兴趣爱好,推荐位的依赖。做推荐的同学比写接口的还要多,日志出了问题,推荐就会不准确甚至无法推荐,可见日志的重要性。
Laravel框架初始化好了以后错误和异常处理已经默认配置好了,他的日志是基于一款很好用的日志管理工具Monolog,
首先说一下Monolog,是php下比较全又容易扩展的记录日志组件。其中Symfony 、 CakePHP等知名php框架都内置了Monolog,有兴趣的可以看一下。每个Logger实例都有一个通道和日志处理器栈。每当你添加一条日志记录,它会被发送到日志处理器栈。 你可以创建很多Logger,
每个Logger定义一个通道(db,请求,路由),每个Logger有很多日志处理器。这些通道会过滤日志。每个日志处理器都有一个Formatter(内置的日志显示格式处理器)。你还可以设定日志级别。(官网解释)
日志配置:Laravel目前支持四种日志处理器,
Single(将日志记录到单个文件中。该日志处理器对应,对应StreamHandler), Daily (以日期为单位将进行日志记录对应RotatingFileHandler) Syslog(将日志记录到Syslog中。对应SysLogHandler) Errorlog(将日志记录到PHP的error_log中。对应ErrorLogHandler)
明白了日志的处理方式我们就可以设置自己需要的方式,在 config/app.php中的对应项设置(默认的):
'log' => 'single',
2、使用Log记录日志
Laravel提供了Log方法记录日志,Log
实际上使用的 Illuminate\Log\Writer
,应为在其中 Writer
的构造函数中注入了Monolog\Logger
。生成的日志文件存放在storage/logs
目录下。
如下:
Log::emergency($error); //紧急,如系统挂掉
Log::alert($error); //需要立即采取行动,如数据库异常等
Log::critical($error); //严重问题,如异常
Log::error($error); //运行时错误,不需要立即处理但需要被记录和监控
Log::warning($error); //警告但不是错误,比如使用了被废弃的API
Log::notice($error); //普通但值得注意的事件
Log::info($error); //感兴趣的事件,比如登录、退出
Log::debug($error); //详细的调试信息
3、按照自己的需求记录日志
Laravel中如果按照原来的配置貌似不能按照自己的需求记录日志,我就按照自己的需求写了一个,供大家参考,当然你可以跳过他提供的日志处理方法Log,在容器中把 Monolog对象写入容器,可以写成单例的形式,这样在加载的时候只实例化一次,然后按照monolog来配置自己想要的记录日志的方法。
class Save_log
{
//存放每个级别实例
private static $obj_log = []; //日志类型映射
private static $classify_arr = ['default', 'debug_log','error_log']; /**
* 单利初始化以及调取对象
* @param $classify 日志的的频道,对应不同的目录
* @param $max_num 日志记录的最大数量
*/
public static function get_log_instance($classify = 'default', $max_num = 0)
{
if(empty(self::$obj_log[$classify])) {
self::$obj_log[$classify] = new Writer(new Logger($classify));
self::$obj_log[$classify]->useDailyFiles(self::get_path($classify), $max_num);
}
return self::$obj_log[$classify];
} /**
* 映射对应的目录
* @param $classify 日志的不同的频道
*/
private static function get_path($classify)
{
$root_path = public_path();
$path = $root_path . '/../../logs/'; //可以是自己的任意路径
$log_arr = self::$classify_arr;
if(!empty($log_arr) && !empty($classify)) {
if(in_array($classify, $log_arr)) {
return $path . $classify. '/' . $classify . '.log';
}
}
return $path . 'default/default.log';
} /**
* 映射对应的目录
* @param $func 调用的方法
* @param $arguments 参数,包括数据和日志等级
*/
public static function __callStatic($func, $arguments)
{
$get_obj = self::get_log_instance($func);
if(empty($get_obj)) {
log::error('Save Log Error!');
}
if(empty($arguments) || !is_array($arguments) || !isset($arguments[0])) {
$get_obj->info('No Data Save!');
} else if(!isset($arguments[1])) {
$get_obj->info($arguments[0]);
} else {
$get_obj->{$arguments[1]}($arguments[0]);
}
}
}
使用的时候可以指定,如下:
Save_log::error_log($info, 'error');
Save_log::debug_log($info);
日志内容如下:
二、上传文件。
Laravel中的上传文件是基于Flysystem提供的文件系统来实现上传,删除,移动。他支持多种驱动,还有一个值得看的云存储,在SAE上需要用到。
文件系统配置位于Config/filesystems.php,我使用的试本地驱动。Laravel中的上传目录有两个:public和Storage两个,有人说这两个一样,其实是有区别的,应该说是各有好处,如果放在public中,服务器可以直接控制访问,方便效率高,放在Storage中可以加上用户控制比如权限等。
上传需要的函数如下:
判断是否进行了上传,是否存在文件:
$request->hasFile('file')
判断上传是否出错:
$file = $request->file('file');
//判断文件上传过程中是否出错
if(!$file->isValid()) {
exit('文件上传出错!');
}
确定上传:
$bytes = Storage::put(
$savePath,
file_get_contents($file->getRealPath())
);
你也可以使用:
$path = $file -> move('storage/uploads');
生成缩略图
Laravel木有提供函数生成缩略图,但是我们可以借助强大的Composer来引入图片处理库 Integration/Image
在项目根目录中的composer.json中的require中添加:"intervention/image": "dev-master",如下图:
然后在config/app.php中providers数组中添加:
Intervention\Image\ImageServiceProvider::class
在aliases数组中添加别名:
'Image' => Intervention\Image\Facades\Image::class,
这样就可以使用了,在类文件中添加:
use Image;
下面是添加水印并且生成缩略图:
$Image->text('@ u/'. $user_id, $news_width - 40 - $length * 10, $news_height - 24, function($font) {
$font->file('public/foos.ttf');
$font->size(14);
$font->color('#ffffff');
});
最后附上整个源码,其中生成缩略图部分可以抽象出来,因为有好几个地方都需要用到,并且水印还有看图片大小等等。
/**
* 上传文件
* @param Object Request
* @return Json result
*/
public function upload_file(Request $request)
{
$user_id = $request->get('user_id');
$width = $request->get('width');
$height = $request->get('height');
$upload_type = $request->get('upload_type');
$watermark = $request->get('watermark'); //参数检查
if(empty($user_id)) {
return response()->json(['code' => 1001, 'msg' => '参数错误']);
} //得到上传文件名
if(!empty($_FILES)) {
$key_arr = array_keys($_FILES);
$file_key = $key_arr[0];
} $file_key = !isset($file_key) || empty($file_key) ? 'fileselect' : $file_key; if(!$request->hasFile($file_key)) {
return response()->json(['code' => 1002, 'msg' => '上传文件为空']);
} $upload_files = $request->file();
if(empty($upload_files) || !is_array($upload_files)) {
return response()->json(['code' => 1003, 'msg' => '上传失败']);
} //兼容单文件上传
if(Utils::arrayLevel($upload_files) < 2) {
$files[$file_key][0] = $upload_files[$file_key];
} else {
$files = $upload_files;
} if($upload_type == 'userphoto' && count($files[$file_key]) > 1) {
return response()->json(['code' => 1004, 'msg' => '头像只能上传一张']);
} if(count($files[$file_key]) > MAX_UPLOAD_FILE) {
return response()->json(['code' => 1005, 'msg' => '大于最大上传数限制']);
} //过滤大于MAX_FILE_SIZE的情况
foreach ($files[$file_key] as $key => $file) {
if($file-> getClientSize() > MAX_FILE_SIZE * 1024 * 1024) {
return response()->json(['code' => 1006, 'msg' => '文件大小不能超过']);
}
} $file_info = [];
$length = strlen($user_id . '');
//兼容批量上传
foreach ($files[$file_key] as $key => $file) {
if(!$file->isValid()) {
return response()->json(['code' => 1007, 'msg' => '上传出错']);
} if($upload_type == 'userpic') {
$file_dir = 'userpic';
} else {
$type = $file->getMimeType();
if(empty($type) && !is_array($type)) {
return response()->json(['code' => 1008, 'msg' => '得到文件类型出错']);
} //映射文件类型
$type_arr = explode("/", $type);
switch($type_arr[0]){
case "image" : $file_dir = "image"; break;
case "video" : $file_dir = "video"; break;
case "audio" : $file_dir = "voice"; break;
case "text" : $file_dir = "doc"; break;
case "application": $file_dir = "doc"; break;
default : $file_dir = "other"; break;
}
} //文件后缀
$postfix = $file->getClientOriginalExtension();
$save_dir = UPLOAD_FILE_PATH;
$file_date = date('Ym');
$file_name = $file_dir . '_' . $file_date . '_' . rand(111111, 999999) . $user_id;
$save_name = $file_name . '.' . $postfix;
$save_path = $file_dir . '/' . $file_date . '/' . $save_name;
Storage::put(
$save_path,
file_get_contents($file->getRealPath())
);
if(!Storage::exists($save_path)) {
return response()->json(['code' => 1009, 'msg' => '保存文件失败']);
} //生成缩略图
if($file_dir == 'image' && (!empty($width) || !empty($height))) {
$Image = Image::make($save_dir . $save_path);
$img_width = $Image->width();
$img_height = $Image->height(); //如果有一个为空,则与另一个相等;
if(empty($width)) {
//传入的高度如果比实际高度大,就取实际高度
$height = $img_height < $height ? $img_height : $height;
$width = $height;
} else if(empty($height)) {
$width = $img_width < $width ? $img_width : $width;
$height = $width;
} else {
$height = $img_height < $height ? $img_height : $height;
$width = $img_width < $width ? $img_width : $width;
} //拼接缩略图路径
$Image->resize($width, $height);
$save_name_s = $file_name . '_s.' . $postfix;
$save_path_s = $save_dir . $file_dir . '/' . $file_date . '/' . $save_name_s;
$file_path_s = $request->root() . '/' . $save_path_s; if($watermark != 1) {
//添加缩略图水印
$news_width = $Image->width();
$news_height = $Image->height();
if($news_width > 100) {
$Image->text('@ u/'. $user_id, $news_width - 40 - $length * 10, $news_height - 24, function($font) {
$font->file('public/foos.ttf');
$font->size(14);
$font->color('#ffffff');
});
}
} //保存缩略图
$Image->save($save_path_s, 100);
$file_size_s = round($Image->filesize() / 1024 ,2) . 'K';
} $file_path = $request->root() . '/' . $save_dir . $save_path;
$file_size = round($file-> getClientSize() / 1024 ,2) . 'K';
$file_info[] = compact(
'save_name', 'file_size', 'file_path', 'save_name_s', 'file_size_s', 'file_path_s'
);
} if(empty($file_info)) {
return response()->json(['code' => 1010, 'msg' => '异常出错']);
} else {
return response()->json(['code' => 0, 'msg' => '', 'data' => $file_info]);
}
}
结束语:
以上是我学习中遇到的一部分问题,不对之处欢迎指正,这篇文章只是说了日志和上传,以后会持续更新,包括路由,中间件,容器等等,还有好多需要说的。