Laravel 文档学习笔记

配置

$_ENV 或 env() 可读取 .env 文件中的变量

读取 config/app.php 中的数据

$value = config('app.timezone');

如何合并、缓存所有配置文件?

# 生成文件 bootstrap/cache/config.php
php artisan config:cache

# 生成文件 bootstrap/cache/route.php
php artisan route:cache

除了 config 文件夹下的配置文件,永远不要在其它地方使用 env 函数,因为部署到线上时,配置文件缓存(php artisan config:cache)后,env 函数无法获得正确的值。

几点注意:

  1. config 文件里严禁使用 Closure 闭包,因为 config:cache 时无法被正确序列化。
  2. routes 文件中尽量不使用闭包函数,统一使用控制器,因为缓存路由的时候 php artisan route:cache,无法缓存闭包函数。

Service Container & Provider

注册:

$app->bind('HelpSpot\API', function ($app) {
    return new HelpSpot\API($app->make('HttpClient'));
});

注册(绑定接口和实现):

$app->singleton(
    Illuminate\Contracts\Http\Kernel::class,
    App\Http\Kernel::class
);

获取:

方式1:app('HelpSpot\API');
方式2:app()->make('HelpSpot\API');
方式3:app()['HelpSpot\API'];
方式4:resolve('HelpSpot\API');

有哪些类是被服务容器解析的?

  • controllers
  • event listeners
  • queue jobs
  • middleware,
  • route Closures.

在给消费者使用前,可以做最后一步监听修改(Container Events)

$this->app->resolving(HelpSpot\API::class, function ($api, $app) {
    // Called when container resolves objects of type "HelpSpot\API"...
});

如果一个提供者中的所有代码,只是为了绑定或者说往容器里注入,那么可以把该提供者设置为懒绑定(延迟提供者绑定 Deferred Providers),例如:

class RiakServiceProvider extends ServiceProvider
{
    // 标记本提供者为延迟绑定
    protected $defer = true;

    public function register()
    {
        $this->app->singleton(Connection::class, function ($app) {
            return new Connection($app['config']['riak']);
        });
    }

    public function provides()
    {
        return [Connection::class];
    }
}

Facades

简单地说,就是一堆类(容器中实例)的快捷别名。

在 config/app.php 的 alias 里配置,这样以后在 Controller 里就可以直接 use 而不用记住一长串的类名。

use Redis;

等价于

use Illuminate\Support\Facades\Redis;

Contract

只是 Laravel 的一个概念,表示一个结构约定。 其实就是 PHP 的 interface,只不过 Contract 不局限于接口,还可以是 Abstract 父类。

路由

模型绑定(Route Model Binding)

直接给 action 传入 Eloquent models(自动根据主键查找)

Route::get('api/users/{user}', function (App\User $user) {
    return $user->email;
});

如果主键不是 id,则可以通过修改 model 的 getRouteKey() 或 getRouteKeyName() 来解决。

模拟 RESTful 方法

<form action="/foo/bar" method="POST">
   <input type="hidden" name="_method" value="PUT">
   <input type="hidden" name="_token" value="">
</form>

等价于:

<form action="/foo/bar" method="POST">
    
    
</form>

中间件

新建中间件:

php artisan make:middleware CheckAge

前置、后置:

class AfterMiddleware
{
    public function handle($request, Closure $next)
    {
        // 前置:干一些事情
        // ...

        $response = $next($request);

        // 后置:干一些事情
        // ...

        return $response;
    }
}

app\Http\Kernel.php 中注册中间件:

全局中间件

protected $middleware = [
    \Illuminate\Foundation\Http\Middleware\CheckForMaintenanceMode::class,
    \Illuminate\Foundation\Http\Middleware\ValidatePostSize::class,
    \App\Http\Middleware\TrimStrings::class,
    \Illuminate\Foundation\Http\Middleware\ConvertEmptyStringsToNull::class,
];

每个请求都会经过这些中间件,例如『维护模式』的检测。

路由中间件


protected $routeMiddleware = [
    'auth' => \Illuminate\Auth\Middleware\Authenticate::class,
];

主要是定义路由时(例如 routes/web.php)使用:

Route::get('/', function () {
    //
})->middleware('auth', 'other');

中间件组

protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
    ],
    'api' => [
        'throttle:60,1',
        'auth:api',
    ],
];

在可以在定义路由时使用:

Route::get('/', function () {
    //
})->middleware('web');

Route::group(['middleware' => ['web']], function () {
    //
});

如何在注册时给中间件传递参数?

冒号隔离,多个参数用逗号,例如:

protected $middlewareGroups = [
    'api' => [
        'throttle:60,1',
    ],
];

或者:

Route::put('post/{id}', function ($id) {
    //
})->middleware('role:editor,boss');

控制器中手动调用中间件:

public function __construct()
{
    $this->middleware('auth');
    $this->middleware('log')->only('index');
    $this->middleware('subscribed')->except('store');
}

Terminable Middleware

在发完响应给客户端后,可以干一些事情。

For example, the “session” middleware included with Laravel writes the session data to storage after the response has been sent to the browser.

namespace Illuminate\Session\Middleware;

class StartSession
{
    public function handle($request, Closure $next)
    {
        return $next($request);
    }

    // Terminable 中间件
    public function terminate($request, $response)
    {
        // 保存 session 数据...
    }
}

当在你的中间件调用 terminate 方法时,Laravel 会从 服务容器 解析一个全新的中间件实例。 如果你希望在 handle 及 terminate 方法被调用时使用一致的中间件实例,只需在容器中使用容器的 singleton 方法注册中间件。

CSRF

任意定义在 routes/web.php 中的路由请求 POST, PUT, or DELETE 提交的表单请求都会自动检测 CSRF 令牌。

可单独例外排除:https://laravel.com/docs/5.4/csrf#csrf-excluding-uris

X-CSRF-TOKEN 需要放入请求头中(如果不放到 form 中的话) X-XSRF-TOKEN 会在每次响应头里的 set-cookie 中返回

Controller

控制器不一定强制要继承 BaseController,但父类控制器 BaseController 包括以下特性:middleware, validate, dispatch 等方法。

控制器的命名空间都是相对 App\Http\Controllers 来说的。

单方法的控制器

生成:

php artisan make:controller PhotoController --resource
// 在 routes/web.php 中定义
Route::get('user/{id}', 'ShowProfile');

// 控制器中写法
class ShowProfile extends Controller
{
    public function __invoke($id)
    {
        return view('user.profile', ['user' => User::findOrFail($id)]);
    }
}

Restful Controller

Route::get('photos/popular', 'PhotoController@method');
Route::resource('photos', 'PhotoController');

方法对照:https://laravel.com/docs/5.4/controllers#resource-controllers

Request

检测请求 URI 是否以指定字符开头:

$request->is('admin/*')

只有调用了 response 实例后,cookie 才会真正被输出到客户端:

$cookie = cookie('name', 'value', $minutes);
return response('Hello World')->cookie($cookie);

文件上传

// 读取 $_FILES['photo']
$file = $request->file('photo');

// 保存(自动生成文件名)
$path = $request->photo->store('保存至目录名');
$path = $request->photo->store('保存至目录名', '磁盘名称');

// 保存(指定文件名)
$path = $request->photo->storeAs('保存至目录名', '重命名.jpg');
$path = $request->photo->storeAs('保存至目录名', '重命名.jpg', '磁盘名称');

Response

跳到指定页

return redirect('home/dashboard');

回到上页

return back()->withInput();

跳到命名路由

return redirect()->route('login');

跳到指定控制器

return redirect()->action('HomeController@index');

返回内容的同时返回header

return response()
    ->view('hello', $data, 200)
    ->header('Content-Type', $type);

弹出附件下载

return response()->download($pathToFile);

直接在浏览器显示。例如 pdf,img

return response()->file($pathToFile);

响应宏设置

// 定义
class ResponseMacroServiceProvider extends ServiceProvider
{
    public function boot()
    {
        Response::macro('caps', function ($value) {
            return Response::make(strtoupper($value));
        });
    }
}

// 执行
return response()->caps('foo');

View

赋值

return view('greetings', ['name' => 'Victoria']);

等价于

return view('greeting')->with('name', 'Victoria');

所有视图共享的数据

在 AppServiceProvider 的 boot() 中:

public function boot()
{
    View::share('key', 'value');
}

视图合成器 View Composers/Creators

可以在指定视图渲染前,或者渲染后,改变一些数据。

使用场景:全局公用的右侧排行榜 widget 组件,例如: https://laravel-china.org/topics/3094

Session

// 读
$value = session('key');

// 读(设缺省值)
$value = session('key', 'default');

// 写
session(['key' => 'value']);

使用 $request->session()->get(‘key’) 和 session(‘key’) 没有实质差别

重新生成 Session ID

通常时为了防止恶意用户进行 Session 固定攻击 Session Fixation

如果你使用了 LoginController 方法,那么 Laravel 会自动重新生成 Session ID,否则,你需要手动使用 regenerate 方法重新生成 session ID

$request->session()->regenerate();

检测一个 key 是否存在(如果值为 null,则结果为 false)

if ($request->session()->has('users')) {
    //
}

检测一个 key 是否存在(即使值为 null,只要 key 存在,则结果为 true)

if ($request->session()->exists('users')) {
    //
}

用 Redis 保存 session

1、修改 .env 中的 SESSION_DRIVER=redis

2、增加 config/database.php 中为 redis 增加一个负责存储 session 的数据库:

'redis' => [

    'client' => 'predis',

    // 其他组
    // ...

    'session' => [
        'host' => env('REDIS_HOST', '127.0.0.1'),
        'password' => env('REDIS_PASSWORD', null),
        'port' => env('REDIS_PORT', 6379),
        'database' => 1,
    ],

],

3、修改 config/session.php 设置 'connection' => 'session'

Validation 输入验证、表单验证

https://laravel.com/docs/5.4/validation

Blade View

https://laravel.com/docs/5.4/blade#control-structures

父模板中定义 section

<!-- Stored in resources/views/layouts/app.blade.php -->

<html>
    <head>
        <title>App Name - @yield('title')</title>
    </head>
    <body>
        @section('sidebar')
            This is the master sidebar.
        @show
        <div class="container">
            @yield('content')
        </div>
    </body>
</html>

子模板中继承并填充 section

<!-- Stored in resources/views/child.blade.php -->

@extends('layouts.app')

@section('title', 'Page Title')

@section('sidebar')
    @parent
    <p>This is appended to the master sidebar.</p>
@endsection

@section('content')
    <p>This is my body content.</p>
@endsection

组件和插槽

定义一个 alert 组件:

<div class="alert alert-danger">
    <div class="alert-title"></div>
    
</div>

外部如何使用:

@component('alert')
    @slot('title')
        Forbidden
    @endslot
    You are not allowed to access this resource!
@endcomponent

最终会生成:

<div class="alert alert-danger">
    <div class="alert-title">Forbidden</div>
    You are not allowed to access this resource!
</div>

显示未经 htmlentities 后的 Dangerous HTML

Hello, {!! $name !!}.

我就是想显示两个花括号,怎么办?

Hello, @.

或者用包起一大段:

@verbatim
    <div class="container">
        Hello, .
        
        
    </div>
@endverbatim

循环无记录时的判断:

@forelse ($users as $user)
    <li></li>
@empty
    <p>No users</p>
@endforelse

循环中的一些操作:按条件跳出、按条件继续

@foreach ($users as $user)
    @continue($user->type == 1)
    <li></li>
    @break($user->number == 5)
@endforeach

判断是否首个、最后一个:

@foreach ($users as $user)
    @if ($loop->first)
        This is the first iteration.
    @endif
    @if ($loop->last)
        This is the last iteration.
    @endif
    <p>This is user </p>
@endforeach

循环指定的子模板:

@each('view.name', $jobs, 'job', 'view.empty')

模板里写注释:


在模板里写原生 PHP 代码:

@php
    // ...
@endphp

栈的使用

父组件中定义:

<head>
    <!-- Head Contents -->
    @stack('scripts')
</head>

子组件中使用:

@push('scripts')
    <script src="/example1.js"></script>
    <script src="/example2.js"></script>
@endpush

清理模板缓存(例如增加、修改自定义指令后):

php artisan view:clear

Console/Command

定义命令(新建文件 App/Console/Commands/SendEmail.php):

namespace App\Console\Commands;

use Illuminate\Console\Command;

class SendEmail extends Command
{
    protected $signature = 'email:send
                        {uid : The ID of the user}
                        {--queue= : Whether the job should be queued}';

    protected $description = 'Command description';

    public function handle()
    {
        // 接收参数
        $uid = $this->argument('uid');
        $shouldQueue = $this->option('queue');

        // 要求输入
        $name = $this->ask('What is your name?');
        $password = $this->secret('What is the password?');

        if ($this->confirm('Do you wish to continue?')) {
            $city = $this->anticipate('你在哪个城市?', ['Shanghai', 'Hongkong', 'Beijing']);
            $habbit = $this->choice('你喜欢哪项运动?', ['NBA', 'Football', 'Tennis'], 'NBA');
        }

        // 输出文本
        // line, info, comment, question and error
        $this->info('Display this on the screen');
        $this->error('Something went wrong!');
        $this->line('Display this on the screen');

        // 输出表格
        $headers = ['Name', 'Email'];

        $users = [
            ['Jack', 'jack@hello.com'],
            ['Rose', 'rose@hello.com'],
        ];

        $this->table($headers, $users);

        // 进度条
        $bar = $this->output->createProgressBar(count($users));

        foreach ($users as $user) {
            $this->performTask($user);

            $bar->advance();
        }

        $bar->finish();

        dd($name, $password);
    }
}

注册(在 App/Console/Kernel.php 绑定):

protected $commands = [
    Commands\SendEmails::class
];

除了在 CLI 模式下,在 PHP 代码里如何调用命令?

$exitCode = Artisan::call('email:send', [
    'user' => 1,
    '--queue' => 'default',
    '--force' => true,
]);

// 队列模式(注意如何配置队列?)
Artisan::queue('email:send', [
    'user' => 1, '--queue' => 'default'
]);

如果是在其他 Commands 文件中,则能直接通过 this 调用

$this->call('email:send', [
    'user' => 1, '--queue' => 'default'
]);

// 忽略所有输出
$this->callSilent('email:send', [
    'user' => 1, '--queue' => 'default'
]);

### Laravel REPL Tinker? REPL 即为 Read-Eval-Print Loop,中文译为“读取-求值-输出”循环。 https://github.com/bobthecow/psysh

php artisan tinker

Cache

配置文件在 app/cache.php

访问指定库:

Cache::store('库名')->put('bar', 'baz', 10);

设置默认值: ```php $value = Cache::get(‘key’, ‘default’);

// 异步 $value = Cache::get(‘key’, function () { return DB::table(…)->get(); });

// 等价于 $value = Cache::get(‘key’); if ($value === null) { $value = DB::table(…)->get(); } ```

阅后即焚:

$value = Cache::pull('key');
// 单位:分
Cache::put('key', 'value', $minutes);

// 会清空整台服务器缓存
Cache::flush();

取值后塞回(非常有用):

$users = Cache::remember('users', $minutes, function () {
    return $db->fetchAll(....);
});

// 等价于

$users = $cache->get('users');

if (! $users) {
    $users = $db->fetchAll(...);
}

$cache->set('users', $users);

Collection

我的理解是 PHP 版的 immutable 对象,每次变更都会返回一个新的完整实例。

https://laravel.com/docs/5.4/collections

Higher Order Messages 高阶消息传递(Laravel 5.4 新特性)

支持方法:contains, each, every, filter, first, map, partition, reject, sortBy, sortByDesc, and sum.

举例说明:

原来写法:

$invoices->each(function ($invoice) {
    $invoice->pay();
});

变成了:

$invoices->each->pay();

另一个例子:

原来写法:

$employees->reject(function ($employee) {
    return $employee->retired;
})->each(function ($employee){
    $employee->sendPayment();
});

变成了:

$employees->reject->retired->each->sendPayment();

Error & Log

错误日志级别:debug, info, notice, warning, error, critical, alert, emergency

use Illuminate\Support\Facades\Log;

Log::emergency($message, $contextualInfo);
Log::alert($message);
Log::critical($message);
Log::error($message);
Log::warning($message);
Log::notice($message);
Log::info($message);
Log::debug($message);

// 或者全局助手方法

// Log::info()
info('Some helpful information!');

// Log::debug()
logger('Debug message');

// Log::error()
logger()->error('You are not allowed here.');

Event 事件与监听

为了代码解耦,使用场景例如,下订单后发送通知,这样就可以把发送通知的代码放到监听者中。

通过 $listen 数组来注册事件和监听:

修改 app/Provider/EventServiceProvider.php 中的 $listen 属性:

protected $listen = [
    'App\Events\SomeEvent' => [
        'App\Listeners\EventListener',
    ],
];

生成事件和监听者类文件:

php artisan event:generate

会根据上面的 $listen 自动生成收发双方两个文件:

  • app\Events\SomeEvent.php
  • app\Listeners\EventListener.php

监听者 EventListener 代码如下:

namespace App\Listeners;

use App\Events\SomeEvent;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;

class EventListener
{
    use InteractsWithQueue;

    // 队列连接名和队列名(省略则是使用缺省队列)
    public $connection = 'sqs';
    public $queue = 'listeners';

    public function handle(SomeEvent $event)
    {
        // 在这里写处理逻辑
    }
}

如果想阻止冒泡(传播给其他监听者),那么在 handle() 里返回 false 即可,其他该事件的监听者将不再处理该事件。

同样,如果监听者可能要处理长时间的逻辑,那么可以实现 ShouldQueue 接口,则自动会进入异步队列执行。

trait InteractsWithQueue 的作用是让我们可以手动操纵一个队列元素(queue job),例如进行 delete 或 release 等操作。

class SendShipmentNotification implements ShouldQueue
{
    use InteractsWithQueue;

    public function handle(OrderShipped $event)
    {
        if (true) {
            // 30秒后重新塞回队列
            $this->release(30);
        }
    }
}

手动设置监听

在 EventServiceProvider.php 的 boot() 方法体内增加:

public function boot()
{
    parent::boot();

    Event::listen('event.name', function ($foo, $bar) {
        //
    });

    Event::listen('event.*', function ($eventName, array $data) {
        //
    });
}

Event Subscribers 订阅者

之前在 EventServiceProvider::$listen 中注册的监听者,一个监听者只能监听一个事件。现在引入新的写法 EventServiceProvider::$subscribe,订阅者也是监听者,但可以同时监听多个事件。

注册订阅者:

class EventServiceProvider extends ServiceProvider
{
    protected $subscribe = [
        'App\Listeners\UserEventSubscriber',
    ];
}

订阅者实现 app\Listeners\UserEventSubscriber.php

namespace App\Listeners;

class UserEventSubscriber
{
    /**
     * Register the listeners for the subscriber.
     *
     * @param  Illuminate\Events\Dispatcher  $events
     */
    public function subscribe($events)
    {
        $events->listen(
            'Illuminate\Auth\Events\Login',
            'App\Listeners\UserEventSubscriber@doSth1'
        );

        $events->listen(
            'Illuminate\Auth\Events\Logout',
            'App\Listeners\UserEventSubscriber@doSth2'
        );
    }

    public function doSth1($event)
    {
    }

    public function doSth2($event)
    {
    }
}

File Storage

use Illuminate\Support\Facades\Storage;
use Illuminate\Http\File;

// 相当于 file_put_content
Storage::put('file.jpg', $contents);

// 自动生成保存后的文件名
Storage::putFile('保存至目录', new File('/path/to/photo.jpg'));

// 手动指定保存后的文件名
Storage::putFileAs('保存至目录', new File('/path/to/photo.jpg'), '新文件名');

将上传文件($_FILES)保存

文件名自动生成:

$path = $request->file('avatar')->store('保存至目录');
// 或
$path = Storage::putFile('保存至目录', $request->file('avatar'));

手动指定文件名: php $path = $request->file('avatar')->storeAs('保存至目录', '新文件名'); // 或 $path = Storage::putFileAs('保存至目录', $request->file('avatar'), '新文件名');

Helpers

我觉得一些常用的:

app_path()
base_path('vendor/bin');
config_path()

// 等价于 htmlspecialchars
e('<html>foo</html>');

// read config
config('app.timezone');

// 生成密码
$password = bcrypt('my-secret-password');

// get cache
$value = cache('key');
$value = cache('key', 'default');

// set cache
cache(['key' => 'value'], 5);
cache(['key' => 'value'], Carbon::now()->addSeconds(10));

// 记录日志
info('User login attempt failed.', ['id' => $user->id]);
logger('User has logged in.', ['id' => $user->id]);
logger()->error('You are not allowed here.');

// retry
return retry(5, function () {
    // Attempt 5 times while resting 100ms in between attempts...
}, 100);

// request()
$request = request();
$value = request('key', $default = null)

// response()
return response('Hello World', 200, $headers);
return response()->json(['foo' => 'bar'], 200, $headers);

Queue

缺省队列

在文件 config/queue.phpconnections 数组里:

'redis' => [
    'driver' => 'redis',
    'connection' => 'queue',
    'queue' => 'default',   // 缺省队列,当 push 时不填队列名,则进入缺省队列
    'retry_after' => 90,
],

创建任务:

php artisan make:job SendReminderEmail

如何入列?

// push 到缺省队列
dispatch(new Job);

// push 到指定队列
dispatch((new Job)->onQueue('指定队列名'));

// push 到指定连接的指定队列
dispatch((new Job)->->onConnection('sqs')->onQueue('指定队列名'));

如何出列?


php artisan queue:work [缺省连接名] [--queue=缺省队列名]

php artisan queue:work 连接名 --queue=队列1(高优先),队列2(低优先) --tries=最大重试次数

平滑重启队列

php artisan queue:restart
php artisan queue:work
   {connection? : The name of connection}
   {--queue= : The queue to listen on}
   {--daemon : Run the worker in daemon mode (Deprecated)}
   {--once : Only process the next job on the queue}
   {--delay=0 : Amount of time to delay failed jobs}
   {--force : Force the worker to run even in maintenance mode}
   {--memory=128 : The memory limit in megabytes}
   {--sleep=3 : Number of seconds to sleep when no job is available}
   {--timeout=60 : The number of seconds a child process can run}
   {--tries=0 : Number of times to attempt a job before logging it failed, 如果不指定,表示无限重试}

retry_after 和 —timeout

retry_after 在 config/queue.php 中每个队列连接中设置,缺省是90秒。 –timeout 在出列命令众设置,或者单个 Job 类中设置,缺省是60秒。

namespace App\Jobs;

class ProcessPodcast implements ShouldQueue
{
    public $tries = 5;
    public $timeout = 120;
}

retry_after 必须比 –timeout 大,否则任务可能执行两次。 具体没搞懂。待研究

If queued listener exceeds the maximum number of attempts as defined by your queue worker, the failed method will be called on your listener. The failed method receives the event instance and the exception that caused the failure:

class SendShipmentNotification implements ShouldQueue
{
    use InteractsWithQueue;

    public function handle(OrderShipped $event)
    {
        //
    }

    public function failed(OrderShipped $event, $exception)
    {
        //
    }
}

任务的前置、后置事件

放入到任意一个 ServiceProvider 中

Queue::before(function (JobProcessing $event) {
    // $event->connectionName
    // $event->job
    // $event->job->payload()
});

Queue::after(function (JobProcessed $event) {
    // $event->connectionName
    // $event->job
    // $event->job->payload()
});

// execute before the worker attempts to fetch a job from a queue.
Queue::looping(function () {
    while (DB::transactionLevel() > 0) {
        DB::rollBack();
    }
});

Supervisor

配置文件在 /etc/supervisor/conf.d 目录中

重试失败任务

# 列出 failed_jobs 中的失败任务
php artisan queue:failed

# 重试指定失败任务id
php artisan queue:retry 5

# 重试所有失败任务
php artisan queue:retry all

# 忽略指定失败任务id
php artisan queue:forget 5

# 清空所有失败任务
php artisan queue:flush

计划任务 Schedule Tasks

$schedule
    ->command('foo')
    ->weekdays()
    ->hourly()
    ->timezone('America/Chicago')
    ->between('8:00', '17:00')
    ->when(function () {
        return true;
    })
    ->before(function () {
        // Task is about to start...
    })
    ->after(function () {
        // Task is complete...
    })
    ->appendOutputTo('日志输出绝对路径')
    ->emailOutputTo('foo@example.com')
    ->pingBefore('通知外部URL')
    ->thenPing('通知外部URL');

Note: The emailOutputTo, sendOutputTo and appendOutputTo methods are exclusive to the command method and are not supported for call.

如何防止任务重叠执行?

$schedule->command('emails:send')->withoutOverlapping();

让计划任务在维护模式时仍然执行

$schedule->command('emails:send')->evenInMaintenanceMode();

Mail

定义邮件

首先在 config/mail.php 中定义全局 from 发送者:

'from' => [
    'address' => 'noreply@bigins.cn',
    'name' => 'App Name'
],
// 生成普通 HTML 邮件模板
// 文件路径为 app/Mail/OrderShipped.php
php artisan make:mail OrderShipped

// 生成 Markdown 格式邮件模板
php artisan make:mail OrderShipped --markdown=emails.orders.shipped

OrderShipped 类中的所有 public 成员变量都会自动传递到模板中。另外也可以在调用 view() 时单独传递变量。

普通邮件模板(支持 Blade)里传递变量:

public function build()
{
    return $this->view('emails/orders/shipped', [
        'orderName' => $this->order->name,
        'orderPrice' => $this->order->price,
    ]);
}

Markdown 邮件模板里传递变量:

public function build()
{
    return $this->markdown('emails/orders/shipped', [
        'orderName' => $this->order->name,
        'orderPrice' => $this->order->price,
    ]);
}

Markdown 邮件模板里面一些组件的写法,参考官方文档: https://laravel.com/docs/5.4/mail#markdown-mailables

发送邮件

直发:

Mail::to('silverd@qq.com')
    ->send(new OrderShipped($order));

用队列发:

$message = (new OrderShipped($order))
    ->onConnection('sqs')
    ->onQueue('emails');

Mail::to('silverd@qq.com')
    ->queue($message);

用队列发的第二种方法,定义邮件时实现 ShouldQueue 接口,并定义好连接和队列名(未经测试):

use Illuminate\Contracts\Queue\ShouldQueue;

class OrderShipped extends Mailable implements ShouldQueue
{
    public $connection = 'sqs';
    public $queue = 'emails';
}

开发环境假装发邮件

  • 方法1:修改 .env 把 MAIL_DRIVER 改为 log,则只会记录邮件发送日志,不会真发
  • 方法2:在 config/mail.php 中增加以下全局收件人,则所有邮件都会发送给这个假人
'to' => [
    'address' => 'op.sh@bigins.com',
    'name' => 'Example'
],

Notification 通知系统

可以构建一个简单的站内信系统,可选择是否同时发送 SMS/Email/Slack 等。

生成新通知:

php artisan make:notification InvoicePaid

发送方式(有两种)

use App\Notifications\InvoicePaid;

$user->notify(new InvoicePaid($invoice));

Database

Eloquent ORM

Relation 多表关系

一对一 One To One

场景:用户表(users)、用户设置表(user_settings)

class User extends Model
{
    public function settings()
    {
        return $this->hasOne('App\Models\Settings', 'user_id', 'id');
    }
}

然后通过动态属性 User::find(1)->settings 可以读取。

外键可以自定义:

return $this->hasOne('App\Models\Settings', 'user_settings 表的 uid 字段名', '本表的 uid 字段名');

hasOne 的反向定义:belongsTo(貌似很少有这样的使用场景)

class UserSettings extends Model
{
    public function user()
    {
        return $this->belongsTo('App\Models\User', '本表的 uid 字段名', 'users 表的 uid 字段名');
    }
}

一对多 One To Many

场景:文章表(posts)、文章评论表(comments)

定义:

class Post extends Model
{
    public function comments()
    {
        return $this->hasMany('App\Models\Comment', 'foreign_key', 'local_key');
    }
}

读取:

$comments = App\Post::find(1)->comments;

或者带条件的:

$comments = App\Post::find(1)->comments()->where('title', 'foo')->first();

foreach ($comments as $comment) {
    // ...
}

hasMany 的反向定义也是:belongsTo

class Comment extends Model
{
    public function post()
    {
        return $this->belongsTo('App\Models\Post', 'post_id', 'id');
    }
}

读取:

$comment = App\Models\Comment::find(1);
echo $comment->post->title;

多对多 Many To Many

场景:用户表(users)、角色组(roles)、用户角色关系(role_user)

class User extends Model
{
    public function roles()
    {
        return $this->belongsToMany('App\Models\Role', 'role_id');
    }
}

### 多级 Has Many(Has Many Through)

场景:取指定国家的人发表的所有文章

countries 国家表
    id - integer
    name - string

users 用户表
    id - integer
    country_id - integer
    name - string

posts 文章表
    id - integer
    user_id - integer
    title - string

定义:

class Country extends Model
{
    /**
     * Get all of the posts for the country.
     */
    public function posts()
    {
        return $this->hasManyThrough(
            'App\Models\Post', 'App\Models\User',
            'country_id', 'user_id', 'id'
        );
    }
}

读取:

$country = App\Models\Country::find(1);
echo $country->posts;

多态关联(Polymorphic Relations)

非常有用和常见的一种关系,例如通用的评论系统,可以有文章评论,也可以有视频评论:

posts 文章表
    id - integer
    title - string
    body - text

videos 视频表
    id - integer
    title - string
    url - string

comments 通用评论表
    id - integer
    body - text
    commentable_id - integer
    commentable_type - string -- 重点:存储的模型 class 名,例如 App\Models\Post

Model 定义:

class Comment extends Model
{
    /**
     * Get all of the owning commentable models.
     */
    public function commentable()
    {
        return $this->morphTo();
    }
}

class Post extends Model
{
    /**
     * Get all of the post's comments.
     */
    public function comments()
    {
        return $this->morphMany('App\Models\Comment', 'commentable');
    }
}

class Video extends Model
{
    /**
     * Get all of the video's comments.
     */
    public function comments()
    {
        return $this->morphMany('App\Models\Comment', 'commentable');
    }
}

读取指定文章的评论:

$post = App\Models\Post::find(1);

foreach ($post->comments as $comment) {
    //
}

Eager Loading 热心加载

十分常见、重要的一个特性。例如场景:书籍表(books)、作者表(authors)

class Book extends Model
{
    /**
     * Get the author that wrote the book.
     */
    public function author()
    {
        return $this->belongsTo('App\Models\Author');
    }
}

显示书籍列表,同时显示每本书的作者名:

$books = App\Models\Book::all();

foreach ($books as $book) {
    echo $book->author->name;
}

以上会产生 N+1 条SQL查询:

select * from books;
select * from authors where id = 1;
select * from authors where id = 2;
...
select * from authors where id = $N;

常见的解决办法是:先用 select ... from authors where in 批量查询作者名,然后再循环赋值回 $books。

Laravel 犀利地提供了一个非常简便的办法:通过 with 方法,即可实现 select in 热心加载:

$books = App\Models\Book::with('author')->get();

foreach ($books as $book) {
    echo $book->author->name;
}

以上相当于只执行了2条SQL:

select * from books;
select * from authors where id in (1, 2, 3, 4, 5, ...);

另外 with 方法可以同时预加载多个关系属性:

$books = App\Models\Book::with('author', 'publisher')->get();

加入额外的条件:

$users = App\Models\Book::with(['author' => function ($query) {
    $query->where('name', 'LIKE', '%silverd%');
}])->get();

### Lazy Eager Loading(重要)

$books = App\Models\Book::all();

if (一些条件) {
    $books->load('author', 'publisher');
}

或者

if (一些条件) {
    $books->load(['author' => function ($query) {
        $query->orderBy('published_date', 'asc');
    }]);
}

### Touching Parent Timestamps

当子模型(belongsTo/belongsToMany)更新后,如何自动更新父模型的 updated_at 字段?

只需要在子模型内增加 $touches 成员属性即可。

class Comment extends Model
{
    /**
     * All of the relationships to be touched.
     *
     * @var array
     */
    protected $touches = ['post'];

    /**
     * Get the post that the comment belongs to.
     */
    public function post()
    {
        return $this->belongsTo('App\Models\Post');
    }
}

Mutators 修改器

例如时间戳字段,读出时转成日期格式,存入时转为 int。 又如某个字段存储 JSON 数据,读出时自动 json_decode,存入时自动 json_encode

举例:order 表的 extra_info 字段是以 JSON 格式存储:

class Order extends Model
{
    // Accessor 访问器
    public function getExtraInfoAttribute($value)
    {
        return json_decode($value, true);
    }

    // Mutator 修改器
    public function setExtraInfoAttribute($value)
    {
        $this->attributes['extra_info'] = json_encode($value);
    }
}

读取:

$order = App\Models\Order::find(1);
$extraInfo = $order->extra_info;

如果仅仅需要做属性的类型强制转换,可以有更简单的方法(Attribute Casting),定义 $casts 属性,支持的类型转换有:integer, real, float, double, string, boolean, object, array, collection, date, datetime, timestamp

class User extends Model
{
    /**
     * The attributes that should be casted to native types.
     *
     * @var array
     */
    protected $casts = [
        'is_admin' => 'boolean',
        'view_count' => 'integer',
        'extra_info' => 'array',
    ];
}

存储时,extra_info 会自动序列化成 JSON 字符串:

$user = App\User::find(1);
$options = $user->options;
$options['key'] = 'value';
$user->options = $options;
$user->save();

Eloquent: Serialization

如何把 Models & Collections 转成数组?

$users = App\User::all();
return $users->toArray();

甚至是含有 relationship 的多层级也能转:

$user = App\User::with('roles')->first();
return $user->toArray();

转成 JSON:

$user = App\User::find(1);
echo $user->toJson();

或者自动触发实例的 __toString() 方法来实现 JSON 自动转换:

echo (string) $user;

既然能把实例当字符串输出,那么路由或控制器就能直接返回,便会自动变成 JSON 输出了:

Route::get('users', function () {
    return App\Model\User::all();
});

隐藏 toArray/toJson 后的个别字段:

class User extends Model
{
    /**
     * The attributes that should be hidden for arrays.
     *
     * @var array
     */
    protected $hidden = ['password', 'posts()'];
}

特别注意:When hiding relationships, use the relationship’s method name, not its dynamic property name.

或者使用 $hidden 的反向:$visible(白名单)

class User extends Model
{
    /**
     * The attributes that should be visible in arrays.
     *
     * @var array
     */
    protected $visible = ['first_name', 'last_name'];
}

一次性隐藏、显示个别字段:

return $user->makeVisible('字段名')->toArray();
return $user->makeHidden('字段名')->toArray();

虚拟的动态属性

有些字段,数据表里没有,但是想在模型里赋值,方便外面使用。有点类似于 VueJS 里的 computed 计算属性。可以通过 上文中的 accessor 访问器来实现。

https://laravel.com/docs/5.4/eloquent-serialization#appending-values-to-json

Package/Vendor

这里讨论的是 Laravel 专用扩展。一个扩展可以是一个模块,包含路由、控制器、视图、配置等。

首先必须有一个自己的 SilverServiceProvider,负责向服务容器注册东西。

发布扩展资源

publishes 动作其实就是 vendor 里代码文件++复制到应用目录去++,让开发者可以使用或自由修改。

扩展配置

public function boot()
{
    // 发布配置文件
    $this->publishes([
        __DIR__ . '/path/to/config/courier.php' => config_path('courier.php'),
    ]);
    // 和原有的配置文件合并(只覆盖第1级下标)
    $this->mergeConfigFrom(
        __DIR__.'/path/to/config/courier.php', 'courier'
    );
}

发布完成后就可以通过 $value = config('courier.option') 来读取了。

扩展路由

public function boot()
{
    // 相当于是 require /path/to/routes.php
    // 里面多了一个路由缓存的判断:如果存在 bootstrap/cache/routes.php 则不引入该文件
    $this->loadRoutesFrom(__DIR__.'/path/to/routes.php');
}

PHP 中 ob_* 系列函数的一些理解

通常来说,ob_* 最常用的用法组合是这样:

<?php

ob_start();
echo '...';
$content = ob_get_contents();

// 清除并关闭缓存,否则会输出到屏幕
ob_end_clean();

// 然后自由处理 $content ...

注:ob_end_* 必须在缓冲区内调用,即必须要有 ob_start 才能 ob_end_*。

输出的多级缓冲机制(ob_start 嵌套)

假设有代码如下:

<?php

ob_start();
echo 'A' . PHP_EOL;
ob_start();
echo 'B' . PHP_EOL;
ob_start();
echo 'C' . PHP_EOL;
ob_end_clean();
ob_end_flush();
ob_end_clean();

结果是什么没有输出,为什么?

每次 ob_start() 都会新建一个缓冲区,PHP 程序本身也有一个最终的输出缓冲区,我们把他叫做F。

步骤解释:

// 初始 F:空

// 新建缓冲区A
// 此时缓存区内容为 F:空, A:空,
ob_start();

// 此时缓存区内容为 F:空, A:'level A'
echo 'level A';

// 新建缓冲区B
// 此时缓存区内容为 F:空, A:'level A', B:空
ob_start();

// 此时缓存区内容为 F:空, A:'level A', B:'level B'
echo 'level B';

// 新建缓冲区C
// 此时缓存区内容为 F:空, A:'level A', B:'level B', C:空
ob_start();

// 此时缓存区内容为 F:空, A:'level A', B:'level B', C:'level C'
echo 'level C';

// 缓冲区C被清空并关闭
// 此时缓存区内容为 F:空, A:'level A', B:'level B'
ob_end_clean();

// 缓冲区B输出到上一级的缓冲区A并关闭
// 此时缓存区内容为 F:空, A:'level A level B'
ob_end_flush();

// 缓冲区A被清空并关闭
// 此时缓冲区A里的内容还没真正输出到最终的F中,因此整个程序也就没有任何输出
ob_end_clean();

flush 和 ob_flush 的区别

1、ob_flush 刷新 PHP 自身的缓冲区 2、flush 只有在 PHP 做为 Apache Module 安装时, 才有实际作用. 它是刷新 WebServer (Apache) 的缓冲区

正确使用俩者的顺序是:先 ob_flush,再 flush。

在其他 sapi 下,不调用 flush 也可以。但为了保证代码可移植性,建议配套使用。

完整的方法说明

PHP 官网文档:http://php.net/manual/zh/ref.outcontrol.php

方法 说明
ob_start 打开输出控制缓冲
ob_clean 清空(擦掉)输出缓冲区
ob_flush 冲刷出(送出)输出缓冲区中的内容
ob_end_clean ob_clean + 关闭输出缓冲
ob_end_flush ob_flush + 关闭输出缓冲
ob_get_clean ob_get_contents + ob_end_clean
ob_get_flush ob_get_contents + ob_end_flush
ob_implicit_flush 打开/关闭隐式刷送。建议关闭。开启相当于在每次 echo/print 后都自动调用 flush()

参考文章:

Nginx 访问日志记录 RespBody 响应内容

Nginx 本身可以通过 $request_body 变量记录请求内容,但响应内容需要通过 Lua 模块来记录:

步骤如下:

安装 LuaJIT:

wget http://luajit.org/download/LuaJIT-2.0.4.tar.gz
tar zxvf LuaJIT-2.0.4.tar.gz
cd LuaJIT-2.0.4
make
make install

安装 Lua:

yum install readline-devel
wget http://www.lua.org/ftp/lua-5.3.3.tar.gz
tar zxvf lua-5.3.3.tar.gz
cd lua-5.3.3
make linux
make install

安装 Nginx 开发包:

cd /usr/local
git clone https://github.com/simpl/ngx_devel_kit.git

安装 LuaNginx 模块:

cd /usr/local
git clone https://github.com/chaoslawful/lua-nginx-module.git

# 使 ld.so.conf 立即生效

刷新动态库路径缓存:

ldconfig --verbose

重新编译 Nginx,加入以下两个参数:

./configure \
    ...
    --add-module=/usr/local/ngx_devel_kit \
    --add-module=/usr/local/lua-nginx-module
make

# 平滑升级
mv /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak
\cp objs/nginx /usr/local/nginx/sbin/nginx
make upgrade

顺便说一下,如果用的是 lnmp1.3-full 一键包,则修改 /root/soft/lnmp1.3-full/lnmp.conf

Nginx_Modules_Options='--add-module=/usr/local/ngx_devel_kit --add-module=/usr/local/lua-nginx-module'

然后执行 cd /root/soft/lnmp1.3-full && ./upgrade.sh nginx,输入 1.10.2 一路回车就行。

编译完 Nginx 后,修改 /usr/local/nginx/conf/nginx.conf,在日志格式中增加 $resp_body 变量:

# 以 staylife 正在用的 `big_api` 格式示例(实际只加了最后一行):
log_format  big_api  '$remote_addr - $remote_user [$time_local] "$request" '
     '$status $body_bytes_sent "$request_body" "$http_referer" '
     '"$http_user_agent" $http_x_forwarded_for "appid=$http_appid,appver=$http_appver,vuser=$http_vuser" '
     '"phpsessid=$cookie_phpsessid,vuser_cookie=$cookie___vuser" '
     '"$resp_body"'
;

新增 /usr/local/nginx/conf/resp_body.conf 文件:

lua_need_request_body on;

set $resp_body "";
body_filter_by_lua '
    local resp_body = string.sub(ngx.arg[1], 1, 1000)
    ngx.ctx.buffered = (ngx.ctx.buffered or "") .. resp_body
    if ngx.arg[2] then
        ngx.var.resp_body = ngx.ctx.buffered
    end
';

修改对应的虚拟主机配置文件 /usr/local/nginx/conf/vhost/staylife.conf

在 PHP 这一段增加引入 resp_body.conf 文件,例如(加了最后一行):

location ~ [^/]\.php(/|$)
{
    fastcgi_pass  unix:/tmp/php-cgi.sock;
    fastcgi_index index.php;
    include fastcgi.conf;
    include pathinfo.conf;
    include resp_body.conf;
}

附:禁止记录 favicon.ico 的请求日志:

location = /favicon.ico {
    log_not_found off;
    access_log off;
}

如何升级 CentOS 的 OpenSSL 库

Nginx 开启 HTTP/2 要求 OpenSSL 库版本必须 1.0.2 以上(因为 1.0.1a~f 有安全威胁,虽然 1.0.1g 已修复)。除了在安装 Nginx 时临时指定 OpenSSL 源码路径外,我们也可以动手将 CentOS 系统自带的 OpenSSL 库升级,一劳永逸。

OpenSSL 官网:https://www.openssl.org

查看当前 OpenSSL 版本:

openssl version -a

先更新 zlib(提供压缩传输支持):

yum install -y zlib

然后开始下载安装 OpenSSL:

# 下载解压
wget https://www.openssl.org/source/openssl-1.0.2j.tar.gz
tar -zxvf openssl-1.0.2j.tar.gz
cd openssl-1.0.2j

# 编译安装
./config shared zlib-dynamic
make && make install

# 备份旧的版本
mv /usr/bin/openssl /usr/bin/openssl.old
mv /usr/include/openssl /usr/include/openssl.old

# 为新的版本建立软链
ln -s /usr/local/ssl/bin/openssl /usr/bin/openssl
ln -s /usr/local/ssl/include/openssl /usr/include/openssl

然后修改系统自带的 OpenSSL 库文件:

# 找到系统库位置(各种 Linux 版本都不同)
# CentOS 6.6 是在以下位置:`/usr/lib64/libssl.so`
find / -name 'libssl.so'

# 建立软链(因为 /usr/local/lib64/ 读取优先级高于 /usr/lib64/)
ln -s /usr/local/ssl/lib/libssl.so /usr/local/lib64/libssl.so

rm -f /usr/lib64/libssl.so
ln -s /usr/local/ssl/lib/libssl.so /usr/lib64/libssl.so

查看 OpenSSL 依赖库版本是否为 1.0.2j 了:

strings /usr/local/lib64/libssl.so | grep OpenSSL

更新可共享的动态链接库的搜索路径:

echo "/usr/local/ssl/lib" >> /etc/ld.so.conf

# 使 ld.so.conf 立即生效
# ldconfig 命令会重建缓存文件 `/etc/ld.so.cache`
# 参数 `-v` 或 `--verbose` 可以让 ldconfig 显示正在扫描的目录及搜索到的共享库
ldconfig --verbose

升级完成。再次看看版本是不是最新的了?

openssl version

参考文章:

SASS 和 Compass 用法小记

安装

# 更新 RubyGems
sudo gem update --system

sudo gem install -n /usr/local/bin sass
sudo gem install -n /usr/local/bin compass

注意务必增加 -n /usr/local/bin,否则安装时会遇到权限问题:

ERROR:  While executing gem ... (Errno::EPERM)
Operation not permitted - /usr/bin/sass

初始化

在父目录执行:

compass create myproject
cd myproject

或者进入已有目录后执行:

compass create init

会生成了一个 config.rb 和两个目录:

|-- config.rb       --- 配置文件
|-- sass/           --- 存放 sass 源文件
|-- stylesheets/    --- 编译后的 css 文件

配置文件 config.rb 的设置详见官方文档

编译

下划线开头的文件(例如 _common.scss)表示局部文件,只能被别的 scss 引用包含。本身不会被编译成单独的 scss 文件。

手动编译:

compass compile [path/to/project]

自动检测文件变化并自动编译:

compass watch [path/to/project]

生产环境需要压缩后的 css 文件,去除注释空行等:

compass compile --output-style compressed

Compass 只编译发生变动的文件,如果你要重新编译未变动的文件,使用 --force 参数:

compass compile --force

也可以通过指定环境配置,智能判断编译模式,修改 config.rb

environment = :development
output_style = (environment == :production) ? :compressed : :expanded

然后用以下命令编译:

compass compile -e production --force

内置模块

Compass 采用模块结构,内置五个模块。官网文档最佳实践

  • reset
  • css3
  • layout
  • typography
  • utilities

如何在自己的 scss 中引用?

@import "compass/reset";

除了模块,Compass 还提供一系列函数。比如 inline-image() 可以将图片转为 data 协议的数据。

@import "compass";
.icon { background-image: inline-image("icon.png"); }

编译后得到

.icon { background-image: url('data:image/png;base64,iBROR...QmCC');}

函数与 mixin 的主要区别是,不需要使用 @include 命令,可以直接调用。

参考文章:

Linux Crontab 拾遗笔记

介绍

Crontab 是一个用于设置周期性被执行任务(即计划任务)的工具。

  • 被周期性执行的任务:Cron Job
  • 周期性执行的任务列表:Cron Table

安装

# 主程序
yum install vixie-cron -y

# 用来安装、卸装、列举用来驱动 cron 守护进程的表格的程序
yum install crontabs -y

# 启动 crond 服务
service crond start|stop|status|try-restart|reload

检测服务状态

+ 方法1:crontab -l
+ 方法2:ps -elf | grep crond | grep -v "grep"
+ 方法3:service crond status

Crond 是什么?

Crond 是一个守护进程,每分钟会从配置文件中刷新并执行定时任务。 每分钟不仅要读一次 /var/spool/cron 内的所有文件,还需要读一次 /etc/crontab。

系统级计划任务 /etc/crontab

分 时 日 月 周 `用户名` /root/do.sh

用户级的计划任务 /var/spool/cron/用户名

# 编辑指定用户的任务表
# -u 缺省不写就代表当前用户
crontab -e [-u 用户名]

# 列举指定用户的任务表
crontab -l [-u 用户名]

# 清除指定用户的任务表
crontab -r [-u 用户名]

补充几点说明:

  1. 执行 crontab -e 实际上是修改文件 vi /var/spool/cron/用户名
  2. 执行 crontab 文件名 时,是直接导入覆盖任务表到 /var/spool/cron/用户名 中。
  3. /etc/cron.d/ 目录里的文件,可以认为是对系统配置的补充文件,会在 crond 运行时自动加载

使用者权限

  • 文件 /etc/cron.deny 中所列用户不允许使用 crontab 命令
  • 文件 /etc/cron.allow 中所列用户允许使用 crontab 命令

配置格式

# Example of job definition:
# .---------------- minute (0 - 59)
# |  .------------- hour (0 - 23)
# |  |  .---------- day of month (1 - 31)
# |  |  |  .------- month (1 - 12) OR jan,feb,mar,apr ...
# |  |  |  |  .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
# |  |  |  |  |
# *  *  *  *  * user-name command to be executed

有趣的配置示例

# 奇数分钟执行
1-59/2 * * * * /root/do.sh

# 偶数分钟执行
*/2 * * * * /root/do.sh

# 表示第 1,3,5,7,9 分钟会执行,第11分钟不会执行
# 即先要满足条件 1~10,再满足逢 2
1-10/2 * * * * /root/do.sh

执行日志

可以通过看日志来知道任务有没有运行 tail -f /var/log/cron

ls /var/log/cron*

- cron(最新的日志文件)
- cron-20161030(截止到10月30日的日志文件)
- cron-20161106
- cron-20161113
- cron-20161120

容易犯错的点

1、环境变量读取

Crontab 执行任务调度时,不会加载任何环境变量,所以请在执行脚本中自己用 source 命令引入环境变量。

另外执行脚本中涉及文件路径时必须写绝对路径。

2、第3个参数(日)和第五个参数(周)是逻辑或的关系

# 四月的第一个星期日0点59分运行
# 注意 %w 百分号要用斜杠转义,因为 % 本身在 Crontab 里是换行的意思
59 0 1-7 4 * test `date +\%w` -eq 0 && /root/do.sh

# 错误的写法:
# 四月的 1~7 号或星期日0点59分运行
59 0 1-7 4 0 /root/do.sh

# 比较(0 真,1 假)
test 1 = 1

# 输出上一条命令的结果
echo $?

3、如何执行周期小于1分钟的任务?

# 每半分钟执行一次
# 写两遍:第1遍每分钟的0秒执行,第2遍虽然也是0秒开始,但会先睡30秒再真正执行脚本
*/1 * * * * /root/do.sh
*/1 * * * * sleep 30s; /root/do.sh

注意清理系统用户的邮件日志

每条任务调度执行完毕,系统都会将任务输出信息通过 mail 形式发送给当前系统用户 /var/spool/mail/用户名,日积月累,日志会很大,因此,将每条任务进行重定向忽略输出:

0 */3 * * * /root/do.sh >/dev/null 2>&1