Laravel 常用包汇总

文章目录

解决跨域——laravel-cors
区分移动端和PC端——jenssegers/agent
快速开发——l5-repository
图片上传到OSS—— johnlui/AliyunOSS
发送模板短信——laravel-sms
查看错误日志——laravel-log-viewer
生成二维码图片——simple-qrcode
权限验证——zizaco/entrust
微信开发——zoujingli/wechat-developer

解决跨域——laravel-cors

场景

laravel作为后端API使用的时候，前端ajax请求的时候 遇到跨域的问题

安装

barryvdh/laravel-cors使用方法很简单

安装： composer require barryvdh/laravel-cors

使用：

app/Http/Kernel.php 在 protected $middleware数组里添加 \Barryvdh\Cors\HandleCors::class

查看效果：这时候ajax 访问就可以没有跨域的问题了

区分移动端和PC端——jenssegers/agent

场景

Laravel User Agent 轻松识别客户端信息 —— jenssegers/agent，客户端会通过这个请求向访问网站提供浏览器类型、操作系统及版本，浏览器渲染引擎，浏览器语言等标识的信息

github地址

https://github.com/jenssegers/agent

安装

安装: composer require jenssegers/agent

使用

$this->agent = new Agent();
//判断是否手机
$this->agent->isMobile()
//判断是否平板
$this->agent->isTablet()
//其余请自行查看手册
……

快速开发——l5-repository

场景

需要快速开发，一键生成所有增删改查，集成了控制器，验证器，模型，仓库，呈现器和转换器等

github地址

https://github.com/andersao/l5-repository

安装

composer require prettus/l5-repository

使用

在您的 config/app.php下的provider数组里添加
Prettus\Repository\Providers\RepositoryServiceProvider::class
如：


providers => [...Prettus\Repository\Providers\RepositoryServiceProvider::class,],

发布配置（将在config下生成repository.php文件）

php artisan vendor:publish

使用以下命令，将创建控制器controller、验证器Validator、模型Model、仓库Repository、呈现器Presenter和转换器Transform的类文件。


php artisan make:entity name

其余的使用请自行查看手册

图片上传到OSS—— johnlui/AliyunOSS

场景

软件需要上传大量的文件或图片，或者是为了方便处理图片，都可以使用阿里云OSS方便我们开发。

github地址

https://github.com/johnlui/AliyunOSS

安装

composer require johnlui/aliyun-oss:~2.0

使用

构建service文件

新建 app/services/OSS.php内容可参考：OSS.php

<?phpnamespace App\Services;use JohnLui\AliyunOSS\AliyunOSS;use Config;class OSS {private $ossClient;public function __construct($isInternal = false){$serverAddress = $isInternal ? Config::get('oss.ossServerInternal') : Config::get('oss.ossServer');$this->ossClient = AliyunOSS::boot($serverAddress,Config::get('oss.AccessKeyId'),Config::get('oss.AccessKeySecret'));}// 默认上传文件使用内网，免流量费public static function upload($ossKey, $filePath, $isInternal = true){$oss = new OSS($isInternal);$oss->ossClient->setBucket('你的Bucket名字');$oss->ossClient->uploadFile($ossKey, $filePath);}/*** 直接把变量内容上传到oss* @param $osskey* @param $content*/public static function uploadContent($osskey,$content){$oss = new OSS(true); // 上传文件使用内网，免流量费$oss->ossClient->setBucket('你的Bucket名字');$oss->ossClient->uploadContent($osskey,$content);}/*** 删除存储在oss中的文件** @param string $ossKey 存储的key（文件路径和文件名）* @return*/public static function deleteObject($ossKey){$oss = new OSS(true); // 上传文件使用内网，免流量费return $oss->ossClient->deleteObject('你的Bucket名字', $ossKey);}/*** 复制存储在阿里云OSS中的Object** @param string $sourceBuckt 复制的源Bucket* @param string $sourceKey - 复制的的源Object的Key* @param string $destBucket - 复制的目的Bucket* @param string $destKey - 复制的目的Object的Key* @return Models\CopyObjectResult*/public function copyObject($sourceBuckt, $sourceKey, $destBucket, $destKey){$oss = new OSS(true); // 上传文件使用内网，免流量费return $oss->ossClient->copyObject($sourceBuckt, $sourceKey, $destBucket, $destKey);}/*** 移动存储在阿里云OSS中的Object** @param string $sourceBuckt 复制的源Bucket* @param string $sourceKey - 复制的的源Object的Key* @param string $destBucket - 复制的目的Bucket* @param string $destKey - 复制的目的Object的Key* @return Models\CopyObjectResult*/public function moveObject($sourceBuckt, $sourceKey, $destBucket, $destKey){$oss = new OSS(true); // 上传文件使用内网，免流量费return $oss->ossClient->moveObject($sourceBuckt, $sourceKey, $destBucket, $destKey);}public static function getUrl($ossKey){$oss = new OSS();$oss->ossClient->setBucket('你的Bucket名字');return $oss->ossClient->getUrl($ossKey, new \DateTime("+1 day"));}public static function createBucket($bucketName){$oss = new OSS();return $oss->ossClient->createBucket($bucketName);}public static function getAllObjectKey($bucketName){$oss = new OSS();return $oss->ossClient->getAllObjectKey($bucketName);}/*** 获取指定Object的元信息** @param  string $bucketName 源Bucket名称* @param  string $key 存储的key（文件路径和文件名）* @return object 元信息*/public static function getObjectMeta($bucketName, $osskey){$oss = new OSS();return $oss->ossClient->getObjectMeta($bucketName, $osskey);}
}

增加相关配置

在app/config/oss.php中增加以下配置

<?php
return ['useInternal' => false,//是否使用OSS内网传输来省流量'ossServer' => '服务器外网地址', //青岛为 http://oss-cn-qingdao.aliyuncs.com'ossServerInternal' => '服务器内网地址', //青岛为 http://oss-cn-qingdao-internal.aliyuncs.com'AccessKeyId' => '阿里云给的AccessKeyId','AccessKeySecret' => '阿里云给的AccessKeySecret',
];

具体实现

use App\Services\OSS;OSS::upload('文件名', '本地路径'); // 上传一个文件echo OSS::getUrl('某个文件的名称'); // 打印出某个文件的外网链接OSS::createBucket('一个字符串'); // 新增一个 Bucket。注意，Bucket 名称具有全局唯一性，也就是说跟其他人的 Bucket 名称也不能相同。OSS::getAllObjectKey('某个 Bucket 名称'); // 获取该 Bucket 中所有文件的文件名，返回 Array。

常见问题

问题1：运行时出现Undefined index: host

原因：配置文件中 ossServer 的值未加http://

问题2：运行时出现The specified bucket is not valid.

原因：内外地址填写时加了BucketName例如http://BucketName.oss-cn-beijing.aliyuncs.com拼接起来就变成了http://bucketName.bucketName.oss-cn...com

解决方案：在配置文件里面ALIOSS_SERVER=http://oss-cn-beijing.aliyuncs.com 这个外网地址前面不要加上 Bucket名字

彩蛋

如果你前端需要处理图片（如：缩放，裁剪，旋转，加水印等），用OSS是非常方便的。详情查看Oss文档

发送模板短信——laravel-sms

场景

发送短信验证码，短信通知等

github地址

https://github.com/toplan/laravel-sms

安装

composer require toplan/laravel-sms:~2.6

使用

详细使用可以参照之前我写过的一篇博客Laravel下的短信验证码注册

查看错误日志——laravel-log-viewer

场景

需要可视化的查看服务器上的错误日志，以便于调试Bug

github地址

https://github.com/rap2hpoutre/laravel-log-viewer

安装

composer require rap2hpoutre/laravel-log-viewer

使用

在config/app.php中的provider里添加

Rap2hpoutre\LaravelLogViewer\LaravelLogViewerServiceProvider::class,

路由里定义

Route::get('logs', '\Rap2hpoutre\LaravelLogViewer\LogViewerController@index');

生成二维码图片——simple-qrcode

场景

需要根据链接地址生成二维码图片

github地址

https://github.com/SimpleSoftwareIO/simple-qrcode

安装

composer require simplesoftwareio/simple-qrcode 1.3.*

使用

在config/app.php中的provider里注册服务提供者

SimpleSoftwareIO\QrCode\QrCodeServiceProvider::class

在config/app.php中的aliases里添加 QrCode 门面

'QrCode' => SimpleSoftwareIO\QrCode\Facades\QrCode::class

基本用法

a. 使用QrCode::generate('Hello,World!');可以生成一个Hello,World!的二维码

b.使用QrCode::format('png')->size(150)->merge('/public/images/logo.png')->errorCorrection('H')->generate('Hello,World!','../public/images/'.$image_name);

讲解：format()为要生成的图片格式，size()为生成的图片大小，merge()为添加二维码中间logo图片，errorCorrection()定义容错级别，为了让二维码保持高可识别度一般定义为errorCorrection(‘H’)，generate()为生成二维码,第一个参数为需要生成二维码的字符串，第二个参数为保存的图片地址。

需要注意的是所有的方法都支持连贯操作，但是generate 方法必须在最后，format 必须在第一个

具体的操作可以查看博客

权限验证——zizaco/entrust

场景

在做后台管理时我们经常会用到权限，限制用户的操作范围

github地址

https://github.com/Zizaco/entrust

安装

composer require zizaco/entrust 5.2.x-dev

使用

在config/app.php中的provider里注册服务提供者

Zizaco\Entrust\EntrustServiceProvider::class,

在config/app.php中的aliases里添加 Entrust 门面

‘Entrust’ => Zizaco\Entrust\EntrustFacade::class,

发布配置文件

php artisan vendor:publish

打开config/auth.php配置，将你的用户表进行关联

'providers' => ['users' => ['driver' => 'eloquent','model' => Namespace\Of\Your\User\Model\User::class,'table' => 'users',],'admins' => ['driver' => 'eloquent','model' => App\Models\Admin::class,'table' => 'admins'],
],

基本使用

(1) 迁移数据库,运行php artisan entrust:migration和php artisan migrate自动生成以下表

roles — 角色表
permissions — 权限表
role_user — 角色和用户之间的关系
permission_role— 角色和权限之间的关系

(2) 创建相应的模型

a.创建Role模型

<?
php namespace App;
use Zizaco\Entrust\EntrustRole;class Role extends EntrustRole
{}

b.创建Permission模型

<?php
namespace App;
use Zizaco\Entrust\EntrustPermission;
class Permission extends EntrustPermission
{}

c.创建Admin模型

<?php
use Zizaco\Entrust\Traits\EntrustUserTrait;
class Admin extends Eloquent
{use EntrustUserTrait; // T添加到你的模型...
}

(3) 创建中间件

在app/Http/Kernel.php中添加'permission' => \App\Http\Middleware\Permission::class,

 protected $routeMiddleware = [……'permission' => \App\Http\Middleware\Permission::class,];

在app/Http/Middeware下创建permisson.php

<?phpnamespace App\Http\Middleware;use App\Models\Admin;
use Closure;
use Illuminate\Http\Request;class Permission
{/*** Handle an incoming request.** @param Request $request* @param Closure $next* @return mixed*/public function handle($request, Closure $next){//获取当前登录的管理员$user = auth()->user();//获取管理员访问的路由$name = $request->route()->action['as'];//判断该管理员是否有权访问该路由if (!$user->can($name)) {abort(403, 'Forbidden');}return $next($request);}
}

(4)定义路由

将你需要做权限限制的路由绑定中间件permisson，比如查看文章需要权限验证：

Route::group(['prefix' => '' , 'middleware'=> 'permission'], function () {Route::resources(['article' => 'ArticleController','articleCat' => 'ArticleCatsController',]);});

微信开发——zoujingli/wechat-developer

场景

当你需要对接第三方微信时，可能会遇到微信支付，发送模板消息，自动回复等场景

github地址

https://github.com/zoujingli/WeChatDeveloper

安装

composer require zoujingli/wechat-developer

使用

请查看官方手册