Php on 七三的小站

PHP 8 从源码安装与配置

Wed, 16 Jul 2025 00:00:00 +0800

1. 一、安装依赖

1.1. 安装编译工具及依赖

CentOS Stream 8/9

#sudo yum groupinstall 'Development Tools'
sudo yum install -y \
    gcc gcc-c++ autoconf \
    systemd-devel openssl-devel libcurl-devel \
    oniguruma-devel zlib-devel \
    libwebp-devel libjpeg-turbo-devel freetype-devel libpng-devel \
    libxml2-devel libxslt-devel \
    libsq3-devel libzip-devel file-devel

Debian/Ubuntu

sudo apt install -y pkg-config gcc autoconf \
	libsystemd-dev libssl-dev libcurl4-openssl-dev \
	libonig-dev libzip-dev libsqlite3-dev \
	libwebp-dev libjpeg-dev libfreetype6-dev libpng-dev \
	libxml2-dev  libxslt-dev libgmp-dev libsodium-dev

1.2. 安装 libiconv

wget https://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.18.tar.gz
tar -zxf libiconv-1.18.tar.gz &&\
cd libiconv-1.18 &&\
./configure --prefix=/usr/local/ &&\
make &&\
sudo make install &&\
sudo ln -s /usr/local/lib/libiconv.so.2.7.0 /usr/lib64/ &&\
sudo ldconfig

1.3. 安装 libzip（已过时，选做）

1.3.1. 通过 RPM 安装

https://pkgs.org/download/libzip

yum remove -y libzip
rpm -Uvh http://rpms.remirepo.net/enterprise/7/remi/x86_64//libzip-last-1.1.3-1.el7.remi.x86_64.rpm
rpm -Uvh http://rpms.remirepo.net/enterprise/7/remi/x86_64//libzip-last-devel-1.1.3-1.el7.remi.x86_64.rpm

1.3.2. 手动编译安装

安装 cmake

wget https://cmake.org/files/v3.26/cmake-3.26.1-linux-x86_64.sh && \
chmod +x cmake-3.26.1-linux-x86_64.sh && \
./cmake-3.26.1-linux-x86_64.sh

mv cmake-3.26.1-linux-x86_64 /usr/local/cmake
ln -s /usr/local/cmake/bin/cmake /usr/local/bin/cmake

编译安装 libzip

wget https://libzip.org/download/libzip-1.10.0.tar.gz &&\
tar -zxf libzip-1.10.0.tar.gz &&\
cd libzip-1.10.0 &&\
mkdir build &&\
cd build &&\
cmake .. &&\
make &&\
make install

更新 lib

echo '/usr/local/lib64
/usr/local/lib
/usr/lib
/usr/lib64'>>/etc/ld.so.conf.d/local.conf

ldconfig

1.4. 安装 imap（已过时，选做）

centOS7 已经没有了 libc-client，需要编译安装

注：epel 源可以找到 libc-client-devel uw-imap-devel uw-imap-static uw-imap-utils，但直接安装还是会出现一些问题。

编译安装

wget ftp://ftp.cac.washington.edu/imap/imap-2007f.tar.gz
tar -zxf imap-2007f.tar.gz
cd imap-2007f
make lr5 PASSWDTYPE=std SSLTYPE=unix.nopwd EXTRACFLAGS=-fPIC IP=4
mkdir -p /usr/local/imap-2007f/{include,lib,c-client}
cp c-client/*.h /usr/local/imap-2007f/include/ && \
cp c-client/*.c /usr/local/imap-2007f/lib/  && \
cp c-client/*.c /usr/local/imap-2007f/c-client/  && \
cp c-client/c-client.a /usr/local/imap-2007f/lib/libc-client.a  && \
cp c-client/c-client.a /usr/local/imap-2007f/c-client/libc-client.a

备注：在 64 位下编译时 make 参数需要带 EXTRACFLAGS=-fPIC ，在 32 位下则不需要。

1.5. 其他（已过时，选做）

yum install -y libicu-devel libmcrypt-devel pam-devel bison bison-devel re2c

libmcrypt-devel 需要使用 epel 源

dnf config-manager --set-enabled powertools
dnf install epel-release epel-next-release

2. 二、安装 PHP

2.1. 下载软件包

mkdir ~/packages && cd ~/packages && \
wget http://us.php.net/distributions/php-8.4.10.tar.gz  && \
sudo tar zxf php-8.4.10.tar.gz -C /usr/local/src

2.2. 新增用户和组 (选做)

# On Ubuntu/Debian:
sudo addgroup --system --gid 37 www-data  && \
sudo adduser \
    --system \
    --home /usr/local/php \
    --shell /bin/false \
    --uid 37 \
    --gecos 'PHP Server' \
    --gid 37 \
    --disabled-password \
    www-data

# On Fedora/RHEL/CentOS:
sudo groupadd --system www-data  && \
sudo adduser \
   --system \
   --shell /bin/bash \
   --comment 'PHP server' \
   --gid www-data \
   --home-dir /usr/local/php \
   --create-home \
   www-data

2.3. 编译安装

cd /usr/local/src/php-8* && \
sudo ./configure \
  --prefix=/usr/local/php \
  --with-config-file-path=/usr/local/php/etc  \
  --with-config-file-scan-dir=/usr/local/php/conf.d  \
  --enable-fpm  \
  --with-fpm-user=www-data  \
  --with-fpm-group=www-data  \
  --with-fpm-systemd  \
  --with-openssl \
  --with-zlib \
  --enable-bcmath \
  --enable-calendar \
  --with-curl  \
  --enable-exif \
  --enable-ftp \
  --enable-gd  \
  --with-webp  \
  --with-jpeg  \
  --with-freetype  \
  --with-gettext  \
  --with-gmp \
  --with-iconv=/usr/local \
  --with-mhash \
  --enable-mbstring \
  --with-mysqli=mysqlnd \
  --enable-pcntl \
  --with-pdo-mysql=mysqlnd \
  --enable-sockets \
  --with-xsl \
  --with-zip \
  --enable-mysqlnd \
  --with-sodium

#make ZEND_EXTRA_LIBS='-liconv' -j4
sudo make -j4
sudo make install

3. 三、php 配置

3.1. php-fpm.conf 设置

sudo mkdir /var/log/php-fpm/ & \
sudo cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf

sudo vim /usr/local/php/etc/php-fpm.conf

pid = /var/run/php-fpm.pid
error_log = /var/log/php-fpm/error.log

3.2. www.conf 设置

sudo vim /usr/local/php/etc/php-fpm.d/www.conf

[www]
user = www-data
group = www-data

listen = /dev/shm/php-fpm.sock
listen.allowed_clients = 127.0.0.1
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
listen.allowed_clients = 127.0.0.1

pm = dynamic
pm.max_children = 30
pm.start_servers = 15
pm.min_spare_servers = 10
pm.max_spare_servers = 20
pm.max_requests = 1024

pm.status_path = /status
ping.path = /ping
access.log = /var/log/php-fpm/$pool.access.log
slowlog = /var/log/php-fpm/$pool.log.slow
request_slowlog_timeout = 10s
request_terminate_timeout = 60

3.3. php.ini 设置

sudo cp php.ini-production /usr/local/php/etc/php.ini

sudo sed -i "s|;*date.timezone =.*|date.timezone = PRC|i" /usr/local/php/etc/php.ini && \
sudo sed -i "s|;*memory_limit =.*|memory_limit = 1024M|i" /usr/local/php/etc/php.ini && \
sudo sed -i "s|;*upload_max_filesize =.*|upload_max_filesize = 2G|i" /usr/local/php/etc/php.ini && \
sudo sed -i "s|;*max_file_uploads =.*|max_file_uploads = 50|i" /usr/local/php/etc/php.ini && \
sudo sed -i "s|;*post_max_size =.*|post_max_size = 2G|i" /usr/local/php/etc/php.ini

3.4. 开机自启动

sudo cp sapi/fpm/php-fpm.service  /usr/lib/systemd/system/ && \
sudo systemctl enable --now php-fpm

3.5. 配置环境变量

sudo vim /etc/profile

PATH=$PATH:/usr/local/mysql/bin:/usr/local/php/bin:/usr/local/nginx/sbin
export PATH

source /etc/profile

4. 四、安装 PHP 扩展

4.1. PHPRedis

git clone https://github.com/phpredis/phpredis.git && \
cd phpredis && \
/usr/local/php/bin/phpize && \
./configure --with-php-config=/usr/local/php/bin/php-config && \
make && sudo make install

4.2. ImageMagick

https://pecl.php.net/package/imagick

安装依赖

sudo yum install autoconf gcc gcc-c++ ImageMagick-devel

下载安装

wget https://pecl.php.net/get/imagick-3.7.0.tgz && \
tar xf imagick-3.7.0.tgz && \
cd imagick-3.7.0 && \
/usr/local/php/bin/phpize && \
./configure --with-php-config=/usr/local/php/bin/php-config && \
make && sudo make install

4.3. php.ini添加扩展

sudo vim /usr/local/php/etc/php.ini

extension=redis
zend_extension=opcache

sudo systemctl restart php-fpm

5. 五、安装 Composer

curl -O https://getcomposer.org/composer.phar && \
sudo mv composer.phar /usr/local/bin/composer && \
sudo chmod +x /usr/local/bin/composer

Laravel 5 开发知乎笔记

Fri, 01 Sep 2017 00:00:00 +0800

第一章基础设置

1.1 开发环境

OS： macOS High Sierra 10.13
Homestead: 6.5
Vagrant box: parallels 4.0.0
Laravel 5.5
PHP 7.1.10 , MySQL 5.7.19 , Nginx 1.13.3

1.2 配置国内软件源

Composer

composer config -g repo.packagist composer https://packagist.laravel-china.org

NodeJS

# 推荐使用 yarn 
yarn config set registry https://registry.npm.taobao.org --global && \
yarn config set disturl https://npm.taobao.org/dist --global && \
yarn config set sass-binary-site https://npm.taobao.org/mirrors/node-sass

# 二选一
npm config set registry https://registry.npm.taobao.org --global && \
npm config set disturl https://npm.taobao.org/dist --global && \
npm config set sass-binary-site https://npm.taobao.org/mirrors/node-sass

# 查看效果
yarn config list

Ubuntu 16.04

sed -i 's/archive.ubuntu.com/mirrors.163.com/g' /etc/apt/sources.list && \
sed -i 's/deb http:\/\/security/#deb http:\/\/security/g' /etc/apt/sources.list && \
sed -i 's/deb-src http:\/\/security/#deb-src http:\/\/security/g' /etc/apt/sources.list && \
apt-get -y update

1.3 创建 Laravel 项目

# 创建项目
composer create-project --prefer-dist laravel/laravel zhihu "5.5.*"

# 更新依赖库
yarn install && \
composer update && \
composer dump-autoload 

# 其他参考命令
yarn install --no-bin-links (windows)
yarn install --force （重构某个包）
npm rebuild node-sass

# 导入 Git 配置文件
cat .gitconfig > ~/.gitconfig
git config --global --edit

1.4 更改 User 模型位置

将 User.php 放置到 app/Models/ 文件夹，命名空间改成：

namespace App\Models;

修改 auth.php 配置文件：

<?php
// config\auth.php
    'providers' => [
        'users' => [
            'driver' => 'eloquent',
            'model' => App\Models\User::class,
        ],
    ],

1.5 数据库 User 表设计

文档：《Laravel 的数据库迁移 Migrations》

设计 User 表结构

<?php
// database/migrations/2014_10_12_000000_create_users_table.php

    public function up()
    {
        Schema::create('users', function (Blueprint $table) {
            $table->increments('id');
            $table->string('name')->unique();
            $table->string('email')->unique();
            $table->string('password');
            $table->string('avatar');
            $table->string('confirmation_token');
            $table->smallInteger('is_active')->default(0);
            $table->string('questions_count')->default(0);
            $table->string('answers_count')->default(0);
            $table->string('comments_count')->default(0);
            $table->string('favorites_count')->default(0);
            $table->string('likes_count')->default(0);
            $table->string('followers_count')->default(0);
            $table->string('following_count')->default(0);
            $table->json('settings')->nullable();
            $table->rememberToken();
            $table->timestamps();
        });
    }

修改 .env 配置信息

运行数据库迁移

php artisan migrate

第二章用户注册后发送验证邮件

2.1 阿里云邮件推送服务

修改 composer.json 然后 composer update

"require": {
    "wang_yan/directmail": "dev-master"
},

或者在项目目录下执行

composer require wang_yan/directmail:dev-master

然后修改 config/app.php，添加服务提供者

<?php
'providers' => [
   // 添加这行
    WangYan\DirectMail\DirectMailTransportProvider::class,
];

最后在 .env 中配置你的密钥，并修改邮件驱动为 directmail

MAIL_DRIVER=directmail

DIRECT_MAIL_KEY=     # AccessKeyId
DIRECT_MAIL_SECRET=  # AccessSecret

2.2 发送注册验证邮件

初始化 Laravel 认证模块

php artisan make:auth

修改 RegisterController 控制器

<?php 
// app\Http\Controllers\Auth\RegisterController.php

    use App\Models\User;
    use Illuminate\Support\Facades\Mail;

    protected function create(array $data)
    {
        $user =  User::create([
            'name' => $data['name'],
            'email' => $data['email'],
            'avatar' => 'default.jpg',
            'confirmation_token' => str_random(40),
            'password' => bcrypt($data['password']),
        ]);

        $this->sendVerifyEmailTo($user);
        return $user;
    }

    private function sendVerifyEmailTo($user)
    {
        $data = [
            'name' => $user->name,
            'url'  => Route('email.verify',['token' => $user->confirmation_token])
        ];

        Mail::send('emails.register', $data, function ($message) use ($user) {
            $message->from('service@dm.mail.wangyan.org', env('APP_NAME','Laravel'));
            $message->to($user->email);
            $message->subject('请验证您的 Email 地址');
        });
    }

修改 User 模型

<?php 
// app\Models\User.php
    protected $fillable = [
        'name', 'email', 'password', 'avatar', 'confirmation_token',
    ];

增加邮件模板

vim resources\views\emails\register.blade.php

增加路由

<?php
// routes\web.php
Route::get('/email/verify/{token}', 'EmailController@verify')->name('email.verify');

增加控制器

php artisan make:controller EmailController

编辑控制器

<?php
// app\Http\Controllers\EmailController.php
use App\Models\User;

class EmailController extends Controller
{
    /**
     * @param $token
     * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
     */
    function verify($token)
    {
        $user = User::where('confirmation_token',$token)->first();

        if(is_null($user)){
            return redirect('/');
        }

        $user->is_active = 1;

        $user->confirmation_token= str_random(40);
        $user->save();

        return redirect('/home');
    }
}

2.3 Sendcloud 邮件服务

修改 composer.json 然后 composer update

"require": {
    "naux/sendcloud": "^1.1",
},

或者在项目目录下执行

composer require naux/sendcloud

修改 config/app.php，添加服务提供者

<?php
'providers' => [
   // 添加这行
    Naux\Mail\SendCloudServiceProvider::class,
];

在 .env 中配置你的密钥，并修改邮件驱动为 sendcloud

MAIL_DRIVER=sendcloud

SEND_CLOUD_USER=   # 创建的 api_user
SEND_CLOUD_KEY=    # 分配的 api_key

第三章用户注册与登录消息提示

3.1 引入 `laracasts/flash` 包

这个包的作用是将消息提示放到 session 中

项目：《Easy Flash Messages for Laravel App》

用法：

flash('Message')->success(): success 样式
flash('Message')->error(): error 样式
flash('Message')->warning(): warning 样式
flash('Message')->overlay(): 弹窗
flash()->overlay('Modal Message', 'Modal Title'): 有标题的弹窗
flash('Message')->important(): 有关闭按钮
flash('Message')->error()->important(): 可以关闭的错误提示

修改 composer.json 然后 composer update

"require": {
    "laracasts/flash": "^3.0"
},

或者在项目目录下执行

composer require laracasts/flash

新增服务提供者

<?php
// config\app.php
'providers' => [
    Laracasts\Flash\FlashServiceProvider::class,
];

修改 EmailController 控制器

<?php
// app\Http\Controllers\EmailController.php
    function verify($token)
    {
        $user = User::where('confirmation_token',$token)->first();

        if(is_null($user)){
            // Render the message as an overlay.
            flash()->overlay('邮箱验证失败！', '温馨提示');
            return redirect('/');
        }

        $user->is_active = 1;

        $user->confirmation_token= str_random(40);
        $user->save();

        flash('邮箱验证成功！')->success()->important();
        return redirect('/home');
    }

修改 HomeController 控制器

<?php
// app\Http\Controllers\HomeController.php
    public function index()
    {
        flash('登入成功！')->success()->important();
        return view('home');
    }

修改视图模板

<?php
// 使用到 overlay() 弹窗时引入
// resources\views\layouts\app.blade.php
    <script>
        $('#flash-overlay-modal').modal();
    </script>

<?php
// 在显示消息的位置引入
// resources\views\home.blade.php
<div class="panel-body">
    @include('flash::message')
</div>

<?php
// resources\views\welcome.blade.php
// 将下面代码放在适当位置
<link href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">

@include('flash::message')

<script src="https://cdn.bootcss.com/jquery/3.2.1/jquery.min.js"></script>
<script src="https://cdn.bootcss.com/bootstrap/3.3.7/js/bootstrap.min.js"></script>
<script>
    $('#flash-overlay-modal').modal();
</script>

3.2 设置帐号未激活不能登录

<?php
// app\Http\Controllers\Auth\LoginController.php
use Illuminate\Http\Request;

protected function attemptLogin(Request $request)
{
    $credentials = array_merge($this->credentials($request),['is_active' => '1']);
    return $this->guard()->attempt(
        $credentials,$request->has('remember')
    );
}

第四章视图文件汉化、增加中文语言包

4.1 简体中文语言包

汉化默认视图文件
将Google字体换成中科大源
增加 cmn-Hans 简体中文语言包

4.2 更新前端资源

项目：《Laravel 资源任务编译器 Laravel Mix》

/* resources/assets/sass/app.scss */
@import url(https://fonts.lug.ustc.edu.cn/css?family=Raleway:300,400,600);

编译

yarn run production

其他详细过程，略

第五章实现找回密码

详细原理（略），可从 app\Http\Controllers\Auth\ForgotPasswordController.php 开始理解

<?php
// app\Models\User.php
use Illuminate\Support\Facades\Mail;

public function sendPasswordResetNotification($token)
{
    $data = [
        'title' => env('APP_NAME','Laravel'),
        'name'  => $this->name,
        'url'   => url('password/reset',$token)
    ];
    Mail::send('emails.reset', $data, function ($message) {
        $message->from('service@sc.mail.wangyan.org', env('APP_NAME','Laravel'));
        $message->to($this->email);
        $message->subject('重设密码');
    });
}

增加邮件模板

vim resources\views\emails\reset.blade.php

第六章设计问题表

文档：Laravel 的数据库迁移 Migrations

创建 Model 的同时，生成 migration 迁移文件

# 注意双反斜杆
php artisan make:model Models\\Question -m

修改 migrate，设计表结构

<?php
// database/migrations/create_questions_table.php
    public function up()
    {
        Schema::create('questions', function (Blueprint $table) {
            $table->increments('id');
            $table->string('title');
            $table->string('body');
            $table->integer('user_id')->unsigned();
            $table->integer('comments_count')->default(0);
            $table->integer('followers_count')->default(0);
            $table->integer('answers_count')->default(0);
            $table->string('close_comment',8)->default('F');
            $table->string('is_hidden',8)->default('F');
            $table->timestamps();
        });
    }

运行迁移

php artisan migrate

第七章发布问题

7.1 安装 UEditor 编辑器

修改 composer.json 然后 composer update

"require": {
    "overtrue/laravel-ueditor": "~1.0"
},

或者在项目目录下执行

composer require "overtrue/laravel-ueditor:~1.0"

添加下面一行到 config/app.php 中 providers 部分

Overtrue\LaravelUEditor\UEditorServiceProvider::class,

发布配置文件与资源

php artisan vendor:publish --provider='Overtrue\LaravelUEditor\UEditorServiceProvider'

附件存储（需要以管理员身份允许终端）

文档：Laravel 的文件系统和云存储功能集成

php artisan storage:link

7.2 发布问题

创建 QuestionsController 控制器

项目：《Laravel 的 HTTP 控制器》

php artisan make:controller QuestionsController --resource

定义 questions 资源路由

<?php
// routes/web.php
Route::resource('questions','QuestionsController');

修改 QuestionsController 控制器

<?php
// app\Http\Controllers\QuestionsController.php
    use App\Models\Question;
    use Illuminate\Support\Facades\Auth;

    // 首页显示所有问题
    public function index()
    {
        $questions = Question::all();
        return $questions;
    }
 
    // 返回创建问题视图
    public function create()
    {
        return view('questions.create');
    }

    // 保存问题，然后返回该问题视图
    public function store(Request $request)
    {
        $data = [
            'title' => $request->get('title'),
            'body' => $request->get('body'),
            'user_id' => Auth::id() // 获取登陆用户 ID
        ];
        $question = Question::create($data); // 保存问题
        return redirect()->route('questions.show',$question->id); // 重定向
    }

    // 返回问题视图
    public function show($id)
    {
        $question = Question::findOrfail($id);
        return view('questions.show',compact('question'));
    }

修改 Question 模型中的 fillable

<?php
// app\Models\Question.php
class Question extends Model
{
    protected $fillable = ['title','body','user_id'];
}

新建「创建问题」视图文件

<?php
//resources\views\questions\create.blade.php
@extends('layouts.app')

@section('content')
    @include('vendor.ueditor.assets')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
                <div class="panel panel-default">
                    <div class="panel-heading">发布问题</div>
                    <div class="panel-body">
                        @include('flash::message')
                        <form action="/questions" method="post">
                            {!! csrf_field() !!}
                            <div class="form-group">
                                <label for="title">标题</label>
                                <input type="text" name="title" class="form-control" placeholder="标题" class="title">
                            </div>
                            <script id="container" name="body" type="text/plain"></script><br>
                            <button type="submit" class="btn btn-block btn-success pull-right">发布问题</button>
                        </form>
                    </div>
                    <script type="text/javascript">
                        var ue = UE.getEditor('container');
                        ue.ready(function() {
                            ue.execCommand('serverparam', '_token', '{{ csrf_token() }}');
                        });
                    </script>
                </div>
            </div>
        </div>
    </div>
@endsection

提交后问题后显示的页面

<?php
//resources\views\questions\show.blade.php
@extends('layouts.app')

@section('content')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
                <div class="panel panel-default">
                    <div class="panel-heading">{{$question->title}}</div>
                    <div class="panel-body">
                        {!! $question->body !!}
                    </div>
                </div>
            </div>
        </div>
    </div>
@endsection

第八章问题表单字段验证

文档：《Laravel 的表单验证机制详解》

8.1 方法一：快速验证

将验证逻辑直接写到控制器中，使用 Illuminate\Http\Request 对象提供的 validate 方法进行验证。

<?php
// app\Http\Controllers\QuestionsController.php
    public function store(Request $request)
    {
        $rules = [
            'title' => 'required|min:6|max:128',
            'body' => 'required|min:12',
        ];
        $messages = [
            'title.required' => '标题不能为空',
            'title.min' => '标题长度至少要6个字符',
            'title.max' => '标题最长不能超过128个字符',
            'body.required' => '内容不能为空',
            'body.min' => '内容至少要有12个字符',
        ];
        $this->validate($request,$rules,$messages);
        $data = [
            'title' => $request->get('title'),
            'body' => $request->get('body'),
            'user_id' => Auth::id()
        ];
        $question = Question::create($data);
        return redirect()->route('questions.show',$question->id);
    }

编辑视图文件

<?php
// resources\views\questions\create.blade.php
@extends('layouts.app')

@section('content')
    @include('vendor.ueditor.assets')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
                <div class="panel panel-default">
                    <div class="panel-heading">发布问题</div>
                    <div class="panel-body">
                        @include('flash::message')
                        <form action="/questions" method="post">
                            {!! csrf_field() !!}
                            <div class="form-group{{ $errors->has('title') ? ' has-error' : '' }}">
                                <label for="title">标题</label>
                                <input type="text" name="title" class="form-control" placeholder="标题" value="{{ old('title') }}" required autofocus>
                                @if ($errors->has('title'))
                                    <span class="help-block">
                                        <strong>{{ $errors->first('title') }}</strong>
                                    </span>
                                @endif
                            </div>
                            <div class="form-group{{ $errors->has('body') ? ' has-error' : '' }}">
                                <script id="container" name="body" type="text/plain">
                                    {!! old('title') !!}
                                </script><br>
                                @if ($errors->has('body'))
                                    <span class="help-block">
                                        <strong>{{ $errors->first('body') }}</strong>
                                    </span>
                                @endif
                            </div>
                            <button type="submit" class="btn btn-block btn-success pull-right">发布问题</button>
                        </form>
                    </div>
                    <script type="text/javascript">
                        var ue = UE.getEditor('container');
                        ue.ready(function() {
                            ue.execCommand('serverparam', '_token', '{{ csrf_token() }}');
                        });
                    </script>
                </div>
            </div>
        </div>
    </div>
@endsection

8.2 方法二：表单请求验证

使用 Artisan 命令 make:request 创建表单请求类来处理更复杂的验证。

php artisan make:request StoreQuestionRequest

添加验证规则到 rules 方法中

注意：表单请求类内也包含了 authorize 方法，用来判断用户是否有权限做出此请求。

<?php
namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
class StoreQuestionRequest extends FormRequest
{
    // 如果你打算在其他地方处理授权逻辑，这里返回 true
    public function authorize()
    {
        return true;
    }

    // 规则
    public function rules()
    {
        return [
            'title' => 'required|min:6|max:128',
            'body' => 'required|min:12',
        ];
    }

    // 自定义错误消息
    public function messages()
    {
        return [
            'title.required' => '标题不能为空',
            'title.min' => '标题长度至少要6个字符',
            'title.max' => '标题最长不能超过128个字符',
            'body.required' => '内容不能为空',
            'body.min' => '内容至少要有12个字符',
        ];
    }
}

修改控制器使用 StoreQuestionRequest 类替换默认的 Request 类

<?php
// app\Http\Controllers\QuestionsController.php
    use App\Http\Requests\StoreQuestionRequest;
    public function store(StoreQuestionRequest $request)
    {
        //
    }

第九章美化编辑器

9.1 登录后才能发布问题

登录后才能发布问题，index 和 show 页面例外。

<?php
// app\Http\Controllers\QuestionsController.php
    public function __construct()
    {
        $this->middleware('auth')->except(['index','show']);
    }

9.2 自定义 toolbars

<!-- 定义容器的高度为200 -->
<script id="container" style="height: 200px" name="body" type="text/plain">
    {!! old('title') !!}
</script>

<script type="text/javascript">
    var ue = UE.getEditor('container', {
        toolbars: [
            ['bold', 'italic', 'underline', 'strikethrough', 'blockquote', 'insertunorderedlist', 'insertorderedlist', 'justifyleft','justifycenter', 'justifyright',  'link', 'insertimage', 'fullscreen']
        ],
        elementPathEnabled: false,
        enableContextMenu: false,
        autoClearEmptyNode:true,
        wordCount:false,
        imagePopup:false,
        autotypeset:{ indent: true,imageBlockLine: 'center' }
    });
    ue.ready(function() {
        ue.execCommand('serverparam', '_token', '{{ csrf_token() }}');
    });
</script>

第十章定义话题与问题关系

10.1 Topic 模型

创建「话题」模型与数据表（请留意单、复数）

question_topic 是 questions 和 topics 的多对多中间表数据库表名是复数，中间表是单数

# 创建模型同时创建 topics 表（复数）
php artisan make:model Models\\Topic -m

# 注意是 create_questions_topics_table 
php artisan make:migration create_questions_topics_table --create=question_topic

定义「话题」数据表结构

<php
// database/migrations/create_topics_table.php
    public function up()
    {
        Schema::create('topics', function (Blueprint $table) {
            $table->increments('id');
            $table->string('name');
            $table->text('bio')->nullable();
            $table->integer('questions_count')->default(0);
            $table->integer('followers_count')->default(0);
            $table->timestamps();
        });
    }

定义「问题」——「话题」数据表结构

// database\migrations\create_questions_topics_table.php
    public function up()
    {
        Schema::create('question_topic', function (Blueprint $table) {
            $table->increments('id');
            $table->integer('question_id')->unsigned()->index();
            $table->integer('topic_id')->unsigned()->index();
            $table->timestamps();
        });
    }

php artisan migrate

定义「问题」——「话题」多对多关系

文档：《Eloquent：关联：多对多》

10.2 Question 模型

问题模型：一个问题属于多个话题

<?php
// app/Models/Question.php
class Question extends Model
{
    protected $fillable = ['title','body','user_id'];

    // 获得此问题所属话题（复数）
    public function topics()
    {
        //  一个问题属于多个话题
        // belongsToMany('关联模型「Topic」','中间表表名','当前模型「Question」在中间表的外键','关联模型「Topic」在中间表的外键')
        // 中间表表名，Eloquent 会按照字母顺序合并两个关联模型的名称
        // question_id 默认采用的是下划线方式命名 
        return $this->belongsToMany(Topic::class)->withTimestamps();
        return $this->belongsToMany('App\Models\Topic', 'question_topic','question_id','topic_id')->withTimestamps();
    }
}

话题模型：一个话题下有多个问题

<?php
// app\Models\Topic.php
class Topic extends Model
{
    protected $fillable = ['name','questions_count','followers_count'];

    public function questions()
    {
        // 参数也可以使用 App\Models\Qeustion
        return $this->belongsToMany(Qeustion::class)->withTimestamps();
    }
}

第十一章使用 Select2 优化话题选择

11.1 编译压缩 Select2 资源

文档：《Laravel 的资源任务编译器 Laravel Mix》

引人 Select2 的 JS、CSS 文件

https://github.com/select2/select2

resources\assets\css\select2.min.css
resources\assets\js\select2.min.js
resources\assets\js\select2.zh-CN.js

引入 JS

// resources\assets\js\app.js
require('./select2.min');
require('./select2.zh-CN');

引入 css

/* resources\assets\sass\app.scss */
@import "../css/select2.min";

禁用缓存

// webpack.mix.js
mix.js('resources/assets/js/app.js', 'public/js')
   .sass('resources/assets/sass/app.scss', 'public/css')
   .version(['public/js/app.js','public/css/app.css']);

编译资源

yarn run production

修改引入文件地址

<?php
// resources\views\layouts\app.blade.php
<link href="{{ mix('css/app.css') }}" rel="stylesheet">

<script src="{{ mix('js/app.js') }}"></script>
@yield('js');

11.2 多选框（静态）

http://select2.github.io/examples.html

<?php
// resources\views\questions\create.blade.php

<div class="form-group">
    <label for="topic">话题</label>
    <select class="js-example-basic-multiple form-control" multiple="multiple">
        <option value="AL">Alabama</option>
        <option value="WY">Wyoming</option>
    </select>
</div>

@section('js')
    <script type="text/javascript">
        $(".js-example-basic-multiple").select2();
    </script>
@endsection

11.3 多选框（动态）

生成测试数据

文档：《Laravel 数据库之：数据填充》

php artisan make:factory TopicFactory

<?php
// database\factories\TopicFactory.php
use Faker\Generator as Faker;

$factory->define(App\Models\Topic::class, function (Faker $faker) {
    return [
        'name' => $faker->word,
        'bio' => $faker->paragraph,
    ];
});

修改 Topic 模型中的 fillable

<?php
// app\Models\Topic.php
protected $fillable = ['name','questions_count','followers_count','bio'];

使用 tinker 填充数据

php artisan tinker
factory(App\Models\Topic::class,10)->create();
quit

定义 Topic 的 api 路由

<?php
// routes\api.php
Route::get('/topics', function (Request $request) {
    $topics = App\Models\Topic::select(['id','name'])->where('name','like','%'.$request->query('q').'%')->get();
    return $topics;
});

修改「创建问题」视图文件

<?php
// resources\views\questions\create.blade.php
<div class="form-group">
    <label for="topic">话题</label>
    <select name="topic[]" class="select2-placeholder-multiple form-control" multiple="multiple"></select>
</div>

@section('js')
    <script type="text/javascript">
        $(document).ready(function() {
            function formatTopic (topic) {
                return  "<div class='select2-result-repository clearfix'>" +
                        "<div class='select2-result-repository__meta'>" +
                        "<div class='select2-result-repository__title'>" +
                        topic.name ? topic.name : "Laravel"   +
                        "</div></div></div>";
            }

            function formatTopicSelection (topic) {
                return topic.name || topic.text;
            }

            $(".select2-placeholder-multiple").select2({
                language: "zh-CN",
                tags: true,
                placeholder: '选择相关话题',
                minimumInputLength: 1,
                ajax: {
                    url: '/api/topics',
                    dataType: 'json',
                    delay: 250,
                    data: function (params) {
                        return {
                            q: params.term,
                        };
                    },
                    processResults: function (data) {
                        return {
                            results: data,
                        };
                    },
                    cache: true
                },
                templateResult: formatTopic,
                templateSelection: formatTopicSelection,
                escapeMarkup: function (markup) { return markup; }
            });
        });
    </script>
@endsection

第十二章创建和显示话题

12.1 新建话题

文档：《Laravel 的集合 Collection》、文档：《Eloquent：多对多关联》

<?php
// app\Http\Controllers\QuestionsController.php
    use App\Models\Topic;
    public function store(StoreQuestionRequest $request)
    {
        // 返回「话题」数组
        // 如果不是数组，则「话题」($topicsArray) 为空
        $topics = $request->get('topic');
        if(is_array($topics)){
            $topicsArray = $this->normalizeTopic($topics);
        }
        $data = [
            'title' => $request->get('title'),
            'body' => $request->get('body'),
            'user_id' => Auth::id()
        ];
        $question = Question::create($data);
        // 使用 attach 方法向「问题」——「话题」中间表插入一条数据
        // 前提是 Question 模型下有 topics() 方法
        $question->topics()->attach($topicsArray);
        return view('questions.show',compact('question'));
    } 
    // collect 函数：从数组中创建一个全新的「集合」实例
    // map 方法遍历集合并将每一个值传入给定的回调
    // map 返回一个新的集合实例,它不会修改它所调用的集合
    private function normalizeTopic(array $topics)
    {
        return collect($topics)->map(function($topic){
            // 如果话题存在，则$topic返回话题的ID（数字类型），否则返回新话题名称
            if(is_numeric($topic)){
                // 该话题的问题数+1
                Topic::find($topic)->increment('questions_count');
                return (int) $topic;
            }
            // 新建话题后返回该话题ID
            $newTopic = Topic::create(['name'=>$topic,'questions_count'=>1]);
            return $newTopic->id;
        })->toArray();
    }

12.2 显示问题的所有话题

QuestionsController 控制器

<?php
// app\Http\Controllers\QuestionsController.php
    public function show($id)
    {
        // 使用 with 方法进行预加载，减少查询次数
        // Question 模型下要有 topics() 方法
        $question = Question::where('id',$id)->with('topics')->first();
        return view('questions.show',compact('question'));
    }

「问题」视图

<?php
// resources\views\questions\show.blade.php
@extends('layouts.app')

@section('content')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
                <div class="panel panel-default">
                    <div class="panel-heading">
                        {{$question->title}}
                        @foreach($question->topics as $topic)
                            <a class="topic btn btn-link pull-right" href="/topic/{{$topic->id}}">{{$topic->name}}</a>
                        @endforeach
                    </div>
                    <div class="panel-body">
                        {!! $question->body !!}
                    </div>
                </div>
            </div>
        </div>
    </div>
@endsection

css 美化

resources\assets\css\style.css

/* resources\assets\sass\app.scss */
@import "../css/style";

yarn run production

第十三章使用 Repository 模式

Repository 模式的目的是将一些高频操作放在一起

在 App\Repositories 文件夹创建 QuestionsRepository

<?php````
// app\Repositories\QuestionsRepository.php
namespace App\Repositories;
use App\Models\Question;
class QuestionsRepository
{
    //通过「问题ID」查找带有「话题」的「问题」
    public function byIdWithTopics($id)
    {
        $questions = Question::where('id',$id)->with('topics')->first();
        return $questions;
    }

    // 根据 $attributes 数组来创建「问题」 
    public function create(array $attributes)
    {
        return Question::create($attributes);
    }
}

编辑 QuestionsController 控制器

<?php
// app\Http\Controllers\QuestionsController.php
use App\Repositories\QuestionsRepository;
class QuestionsController extends Controller
{
    protected $questionRepository;
    
    public function __construct(QuestionsRepository $questionRepository)
    {
        $this->questionRepository = $questionRepository;
        $this->middleware('auth')->except(['index','show']);
    }
    
    public function store(StoreQuestionRequest $request)
    {
        // 修改 $question = Question::create($data);
        $question = $this->questionRepository->create($data);
    }
    
    public function show($id)
    {
        // 修改 $question = Question::where('id',$id)->with('topics')->first();
        $question = $this->questionRepository->byIdWithTopics($id);
    }
}

第十四章实现编辑问题

14.1 编辑问题

路由情况

修改 QuestionsController 控制器

<?php
// app\Http\Controllers\QuestionsController.php
    public function edit($id)
    {
        $question = $this->questionRepository->byID($id);
        // 只有问题创建者才能编辑
        if (Auth::user()->owns($question)){
            return view('questions.edit',compact('question'));
        }
        return back();
    }

在 QuestionsRepository 中，通过ID获取问题

<?php
// app\Repositories\QuestionsRepository.php
class QuestionsRepository
{
    public function byID($id)
    {
        $question = Question::findOrfail($id);
        return $question;
    }
}

只有问题创建者才能编辑自己的问题

<?php
// app\Models\User.php
    use Illuminate\Database\Eloquent\Model;
    public function owns(Model $model)
    {
        // 判断当前用户Id是否等于问题创建者的ID
        // Auth::user()->id == $question->user_id
        return $this->id == $model->user_id;
    }

「编辑问题」视图文件

复制 create.blade.php 文件为edit.blade.php，并修改以下内容:

<?php
// resources/views/questions/edit.blade.php
// PATCH 方法对应的是 update 路由
<form action="/questions/{{ $question->id }}" method="post">
    {{ method_field('PATCH') }}
</form>

14.2 更新问题

QuestionsController 控制器

文档：《多对多关联》

StoreQuestionRequest 是验证规则，sync 用于同步关联

<?php
// app\Http\Controllers\QuestionsController.php
    public function update(StoreQuestionRequest $request, $id)
    {
        
        $question = $this->questionRepository->byID($id);
        $question->update([
            'title' => $request->get('title'),
            'body' => $request->get('body'),
        ]);
        // sync 方法可以接收 ID 数组，向中间表插入对应关联数据记录。
        // 所有没放在数组里的 IDs 都会从中间表里移除。
        $topics = $request->get('topic');
        if(is_array($topics)){
            $topicsArray = $this->normalizeTopic($topics);
        }
        $question->topics()->sync($topicsArray);
        return redirect()->route('questions.show',$question->id);
    }

「问题」视图文件

<?php
// resources/views/questions/show.blade.php
@extends('layouts.app')

@section('content')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
                <div class="panel panel-default">
                    <div class="panel-heading">
                        {{$question->title}}
                        @foreach($question->topics as $topic)
                            <a class="topic btn btn-link pull-right" href="/topic/{{$topic->id}}">{{$topic->name}}</a>
                        @endforeach
                    </div>
                    <div class="panel-body">
                        {!! $question->body !!}
                    </div>
                    <div class="actions panel-footer">
                        @if(Auth::check()  && Auth::user()->owns($question))
                            <span class="edit">
                                <a href="/questions/{{$question->id}}/edit">编辑</a>
                            </span>
                        @endif
                    </div>
                </div>
            </div>
        </div>
    </div>
@endsection

第十五章问题列表和删除问题

15.1 问题列表

编辑问题控制器

http://php.net/manual/zh/function.compact.php

<?php
// app\Http\Controllers\QuestionsController.php
    public function index()
    {
        $questions = $this->questionRepository->getQuestionsFeed();
        return view('questions.index',compact('questions'));
    }

编辑 QuestionsRepository

文档：《本地作用域》

本地作用域允许我们定义通用的约束集合以便在应用中复用，只需简单在对应 Eloquent 模型方法前加上一个 scope 前缀。

<?php
// app\Repositories\QuestionsRepository.php
    public function getQuestionsFeed()
    {
        // 获取 is_hidden 为 false 的问题，并按更新时间排序，同时获取该问题对应的用户信息。
        return Question::published()->latest('updated_at')->with('user')->get();
    }

Eloquent 模型中任何以 scope 开始的方法都被当做 Eloquent scope

<?php
// app\Models\Question.php
    public function scopePublished($query)
    {
        //  约束条件是 is_hidden 为 false
        return $query->where('is_hidden','F');
    }
    
    public function user()
    {
        return $this->belongsTo(User::class);
    }

问题首页视图文件

<?php
// resources\views\questions\index.blade.php
@extends('layouts.app')
@section('content')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
                @foreach($questions as $question)
                    <div class="media">
                        <div class="media-left">
                            <a href="">
                                <!-- 头像地址：public/images/avatar.png -->
                                <img width="48" src="{{ url('images',$question->user->avatar) }}" alt="{{$question->user->name}}" >
                            </a>
                        </div>
                        <div class="media-body">
                            <h4 class="media-heading">
                                <a href="/questions/{{$question->id}}">{{$question->title}}</a>
                            </h4>
                        </div>
                    </div>
                @endforeach
            </div>
        </div>
    </div>
@endsection

15.2 删除问题

视图文件

<?php
// resources\views\questions\show.blade.php
<div class="actions panel-footer">
    @if(Auth::check()  && Auth::user()->owns($question))
        <span class="edit">
            <a href="/questions/{{$question->id}}/edit">编辑</a>
        </span>
        <form action="/questions/{{$question->id}}" method="post" class="delete-form">
            {{method_field('DELETE')}}
            {{csrf_field()}}
            <button class="button delete-button is-naked">删除</button>
        </form>
    @endif
</div>

「删除问题」控制器

<?php
// app\Http\Controllers\QuestionsController.php
    public function destroy($id)
    {
        $question = $this->questionRepository->byID($id);
        if (Auth::user()->owns($question)){
            $question->delete();
            return redirect('/questions/');
        }
        abort(403,'Forbidden');
    }

第十六章创建问题的答案 Answer 模型

# 模型名称首字母大写且是单数，自动创建的数据库表是复数
php artisan make:model models\\Answer -m

<?php
    public function up()
    {
        Schema::create('answers', function (Blueprint $table) {
            $table->increments('id');
            $table->integer('user_id')->index()->unsigned();
            $table->integer('question_id')->index()->unsigned();
            $table->text('body');
            $table->integer('votes_count')->default(0);
            $table->integer('comments_count')->default(0);
            $table->string('is_hidden',8)->default('F');
            $table->string('close_comment',8)->default('F');
            $table->timestamps();
        });
    }

php artisan migrate

Answer 模型

<?php
// app\Models\Answer.php
class Answer extends Model
{
    protected $fillable = ['user_id', 'question_id', 'body'];
    public function user()
    {
        return $this->belongsTo(User::class);
    }
    public function question()
    {
        return $this->belongsTo(Question::class);
    }
}

Question 模型

<?php
// app\Models\Question.php
    public function answers()
    {
        return $this->hasMany(Answer::class);
    }

User 模型

<?php
// app\Models\User.php
    public function answers()
    {
        return $this->hasMany(Answer::class);
    }

第十七章实现提交回答

17.1 创建 Answer 控制器

# 单数
php artisan make:controller AnswerController

定义保存 Answer 的路由

<?php
// routes\web.php
Route::post('questions/{question}/answer','AnswerController@store');

Answer 控制器

<?php
// app\Http\Controllers\AnswerController.php
use App\Repositories\AnswerRepository;
use Illuminate\Support\Facades\Auth;
use Illuminate\Http\Request;

class AnswerController extends Controller
{
    protected $answer;

    public function __construct(AnswerRepository $answer)
    {
        $this->answer = $answer;
    }

    public function store(Request $request, $question)
    {
        // ID 是当前登录用户ID
        $answer = $this->answer->create([
            'question_id' => $question,
            'user_id'     => Auth::id(),
            'body'        => $request->get('body')
        ]);
        // 问题回答数+1
        $answer->question()->increment('answers_count');
        return back();
    }

AnswerRepository 模式

<?php
// app\Repositories\AnswerRepository.php
use App\Models\Answer;
class AnswerRepository
{
    public function create(array $attributes)
    {
        return Answer::create($attributes);
    }
}

17.2 验证 Answer 表单

新建规则文件

php artisan make:request StoreAnswerRequest

<?php
// app\Http\Requests\StoreAnswerRequest.php
public function authorize()
{
    return true;
}
public function rules()
{
    return [
        'body' => 'required|min:12'
    ];
}

将规则依赖注入

<?php
// app\Http\Controllers\AnswerController.php
use App\Http\Requests\StoreAnswerRequest;
public function store(StoreAnswerRequest $request, $question)
{
    //
}

17.3 视图中显示 Answer

修改 byIdWithTopics 为 byIdWithTopicsAndAnswers

<?php
// app\Http\Controllers\QuestionsController.php
    public function show($id)
    {
        $question = $this->questionRepository->byIdWithTopicsAndAnswers($id);
        return view('questions.show',compact('question'));
    }

<?php
// app\Repositories\QuestionsRepositories.php
    public function byIdWithTopicsAndAnswers($id)
    {
        $question = Question::where('id',$id)->with('topics','answers')->first();
        return $question;
    }

「问题」视图

<?php
// resources\views\questions\show.blade.php
@extends('layouts.app')

@section('content')
    @include('vendor.ueditor.assets')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
            <!-- ...... -->
            </div>

            <div class="col-md-8 col-md-offset-2">
                <div class="panel panel-default">
                    <div class="panel-heading">
                        {!! $question->answers_count !!} 个答案
                    </div>
                    <div class="panel-body">
                        @foreach($question->answers as $answer)
                            <div class="media">
                                <div class="media-left">
                                    <a href="">
                                        <img width="48" src="{{ url('images',$answer->user->avatar) }}" alt="{{$answer->user->name}}" >
                                    </a>
                                </div>
                                <div class="media-body">
                                    <h4 class="media-heading">
                                        <a href="/user/{{$answer->user->name}}">
                                            {{$answer->user->name}}
                                        </a>
                                    </h4>
                                    {!! $answer->body !!}
                                </div>
                            </div>
                        @endforeach
                        <form action="/questions/{{$question->id}}/answer" method="post">
                            {!! csrf_field() !!}
                            <div class="form-group{{ $errors->has('body') ? ' has-error' : '' }}">
                                <label for="body">内容</label>
                                <script id="container" style="height: 120px" name="body" type="text/plain">
                                    {!! old('body') !!}
                                </script><br/>
                                @if ($errors->has('body'))
                                <span class="help-block">
                                    <strong>{{ $errors->first('body') }}</strong>
                                </span>
                                @endif
                            </div>
                            <button type="submit" class="btn btn-block btn-success pull-right">提交答案</button>
                        </form>
                    </div>
                </div>
            </div>

        </div>
    </div>
@endsection

@section('js')
<script type="text/javascript">
    var ue = UE.getEditor('container', {
        toolbars: [
            ['bold', 'italic', 'underline', 'strikethrough', 'blockquote', 'insertunorderedlist', 'insertorderedlist', 'justifyleft','justifycenter', 'justifyright',  'link', 'insertimage', 'fullscreen']
        ],
        elementPathEnabled: false,
        enableContextMenu: false,
        autoClearEmptyNode:true,
        wordCount:false,
        imagePopup:false,
        autotypeset:{ indent: true,imageBlockLine: 'center' }
    });
    ue.ready(function() {
        ue.execCommand('serverparam', '_token', '{{ csrf_token() }}');
    });
</script>
@endsection

第十八章用户关注问题

18.1 提交回答需要登录

在前端限制

<?php
// resources\views\questions\show.blade.php
@if(Auth::check())
    <form action="/questions/{{$question->id}}/answer" method="post">
    </form>
@else
    <a href="{{ url('login') }}" class="btn btn-warning btn-block">登录提交答案</a>
@endif

在后端限制

<?php
// app/Http/Controllers/AnswerController.php
public function __construct(AnswerRepository $answer)
{
    $this->middleware('auth');
}

18.2 关注问题

实质是创建 user_question 表，记录了登录用户ID和所关注问题的ID，点击关注该问题便生成一条记录。

18.2.1 数据库迁移

注意 user_question 表是复数

<?php
php artisan make:migration create_user_question --create=user_question

注意 user_id question_id 外键是单数

<?php
// database/migrations/create_user_question.php
Schema::create('user_question', function (Blueprint $table) {
    $table->increments('id');
    $table->integer('user_id')->unsigned()->index();
    $table->integer('question_id')->unsigned()->index();
    $table->timestamps();
});

php artisan migrate

18.2.2 视图文件

<?php
// resources\views\questions\show.blade.php
<div class="container">
        <div class="row">
            <!-- offset-2 改成 offset-1  -->
            <div class="col-md-8 col-md-offset-1">
            ......
            </div>
            <div class="col-md-3">
                <div class="panel panel-default">
                    <div class="panel-heading question-follow">
                        <h2>{{ $question->followers_count }}</h2>
                        <span>关注者</span>
                    </div>
                    <div class="panel-body">
                        <a href="/question/{{$question->id}}/follow" class="btn btn-default">
                            关注该问题
                        </a>
                        <a href="#editor" class="btn btn-primary pull-right">撰写答案</a>
                    </div>
                </div>
            </div>
            <!-- offset-2 改成 offset-1  -->
            <div class="col-md-8 col-md-offset-1">
                <div class="panel panel-default">
                    <div class="panel-heading">
                        {!! $question->answers_count !!} 个答案
                    </div>
                </div>
            </div>
        </div>
    </div>
</div>

18.2.3 路由

<?php
// zhihu\routes\web.php
Route::get('question/{question}/follow','QuestionFollowController@follow');

18.2.4 「关注问题」控制器

php artisan make:controller QuestionFollowController

<?php
// app\Http\Controllers\QuestionFollowController.php
use App\Models\Question;
use Illuminate\Support\Facades\Auth;
public function __construct()
{
    // 需要登录，否则下面 Auth::user() 爆错
    $this->middleware('auth');
}

public function follow($question)
{
    // 别忘了 use Auth
    // $question 是从路由传入的问题ID
    Auth::user()->follows($question);
    Question::find($question)->increment('followers_count');
    return back();
}

18.2.5 模型

<?php
// app\Models\User.php
public function follows($question)
{
   return Follow::create([
       'question_id' => $question,
       'user_id' => $this->id
   ]);
}

php artisan make:model models\\Follow

<?php
// app\Models\Follow.php
class Follow extends Model
{
    protected $table = 'user_question';
    protected $fillable = ['user_id', 'question_id'];
}

第十九章用户关注问题（下）

19.1 使用 toggle 方法避免重复关注

<?php
// app\Http\Controllers\QuestionFollowController.php
public function follow($question)
{
    Auth::user()->followThis($question);
    ......
}

文档：《多对多关联：同步关联》

<?php
// app\Models\User.php
    public function follows()
    {
        // 多对多，一个用户可以关注多个问题，一个问题也能被多个用户关注
        return $this->belongsToMany(Question::class,'user_question')->withTimestamps();
    }
    
    public function followThis($question)
    {
        // 如果给定 ID 已附加，就会被移除。
        // 同样的，如果给定 ID 已移除，就会被附加：
        return $this->follows()->toggle($question);

        // 关注成功则+1，否则反之
        if ($this->followed($question))
            Question::find($question)->increment('followers_count');
        else
            Question::find($question)->decrement('followers_count');
    }

19.2 获取关注状态

<?php
// app\Models\User.php
public function followed($question)
{
    // 通过问题ID查询该用户是否关注该问题 
    return  $this->follows()->where('question_id',$question)->count();
}

前端

<?php
// resources\views\questions\show.blade.php
<div class="panel-body">
    @if(Auth::check())
        <a href="/question/{{$question->id}}/follow"
            class="btn btn-default {{Auth::user()->followed($question->id) ? 'btn-success' : ''}}">
            {{Auth::user()->followed($question->id) ? '已关注' : '关注该问题'}}
        </a>
    @else
        <a href="/question/{{$question->id}}/follow" class="btn btn-warning">关注该问题</a>
    @endif
    <a href="#editor" class="btn btn-primary pull-right">撰写答案</a>
</div>

第二十章使用 Vuejs 实现关注问题

在上一节使用 toggle 避免重复关注，并且使用超链接来实现关注和取消关注。而使用 Vuejs 可以避免跳转，用户体验更佳。

路由

<?php
// routes/api.php

// 根据用户ID和问题ID，查询是否关注成功
Route::post('/question/follower',function (Request $request){
    $followed = \App\Models\Follow::where('question_id',$request->get('question'))
        ->where('user_id',$request->get('user'))
        ->count();
    if ($followed) {
        return response()->json(['followed' => true]);
    }
    return response()->json(['followed' => false]);

})->middleware('api');

// 关注成功后写入数据到 user_question 表
Route::post('/question/follow',function (Request $request){
    $question_id =  $request->get('question');
    $followed = \App\Models\Follow::where('question_id',$question_id)
        ->where('user_id',$request->get('user'))
        ->first();
    //若已经关注，则取消关注
    if ($followed !== null) {
        $followed->delete();
        \App\Models\Question::find($question_id)->decrement('followers_count');
        return response()->json(['followed' => false]);
    }
    //否则写入数据
    \App\Models\Follow::create([
        'question_id'=>$request->get('question'),
        'user_id'=>$request->get('user'),
    ]);
    \App\Models\Question::find($question_id)->increment('followers_count');
    return response()->json(['followed' => true]);

})->middleware('api');

安装 props 包

yarn add props

// resources\assets\js\components\QuestionFollowButton.vue
<template>
    <button
            class="btn btn-default"
            v-bind:class="{'btn-success' : followed}"
            v-text="text"
            v-on:click="follow"
    ></button>
</template>

<script>
    export default {
        props:['question','user'],
        mounted() {
            // 查询是否已经关注
            axios.post('/api/question/follower',{'question':this.question,'user':this.user}).then(response => {
                //console.log(response.data);
                this.followed = response.data.followed
            })
        },
        data(){
            return {
                followed:false //默认值
            }
        },
        computed:{
            text(){
                return this.followed ? '已关注' : '关注该问题'
            }
        },
        methods:{
            // 关注
            follow() {
                axios.post('/api/question/follow',{'question':this.question,'user':this.user}).then(response => {
                    this.followed = response.data.followed
                })
            }
        }
    }
</script>

// resources\assets\js\app.js
Vue.component('question-follow-button', require('./components/QuestionFollowButton.vue'));

视图

 <div class="panel-body">
    @if(Auth::check())
        <question-follow-button question="{{$question->id}}" user="{{Auth::id()}}"></question-follow-button>
    @else
        <a href="/question/{{$question->id}}/follow" class="btn btn-warning">关注该问题</a>
    @endif
    <a href="#editor" class="btn btn-primary pull-right">撰写答案</a>
</div>

编译

yarn run prod

第二十一章前后端分离 API token 认证

21.1 在 `users` 表新增 `api_token` 字段

php artisan make:migration add_api_token_to_users --table=users

<?php
// database\migrations\2017_09_19_133744_add_api_token_to_users.php
    public function up()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->string('api_token',64)->unique();
        });
    }
    public function down()
    {
        Schema::table('users', function (Blueprint $table) {
            $table->dropColumn(['api_token']);
        });
    }

php artisan migrate

将生成的随机字符串手动粘贴到 user 表中

php artisan migrate
php artisan tinker
>>> str_random(60)
=> "79hiXQBXMSWwrZDqybMTxZGjbB0nkFv2DkrAqyGoQ1f9WscoHwTSaB0btktm"
=> "ry8k58UcyZoSZJtIyZtegp3M5pqJbkceEPyC2dxm8zH5NaUoWDR9ykvY1EMX"

注册时自动生成随机字符串

<?php
// app\Http\Controllers\Auth\RegisterController.php
    protected function create(array $data)
    {
        $user = User::create([
            'api_token' => str_random(60),
        ]);
    }

<?php
// app\Models\User.php
  protected $fillable = [
        'api_token'
    ];

21.2 获取前端生成的 `api_token` 字符串

<?php
// resources\assets\js\bootstrap.js
// 注意 Authorization
let apiToken = document.head.querySelector('meta[name="api-token"]');

if (apiToken) {
    window.axios.defaults.headers.common['Authorization'] = apiToken.content;
} else {
    console.error('API token not found');
}

前端从数据库读取 api_token 内容

<?php
// resources\views\layouts\app.blade.php
<meta name="api-token" content="{{  Auth::check() ? 'Bearer '.Auth::user()->api_token : 'Bearer ' }}">

21.3 前端安全优化

去掉 user 部分

// resources\assets\js\components\QuestionFollowButton.vue
    export default {
        props:['question'],
        mounted() {
            axios.post('/api/question/follower',{'question':this.question}).then(response => {
                //
            })
        },
        methods:{
            follow() {
                axios.post('/api/question/follow',{'question':this.question}).then(response => {
                    //
                })
            }
        }
    }

路由部分，新增 $user 并且将 $request->get('user') 替换成 $user->id

<?php
// routes\api.php
Route::post('/question/follower',function (Request $request){
    $user = Auth::guard('api')->user(); //新增内容
    $followed = \App\Models\Follow::where('question_id',$request->get('question'))
        ->where('user_id',$user->id) // 注意 $user->id
        ->count();
})->middleware('auth:api');

Route::post('/question/follow',function (Request $request){
    $user = Auth::guard('api')->user(); //新增内容
    $question_id =  $request->get('question');
    $followed = \App\Models\Follow::where('question_id',$question_id)
        ->where('user_id',$user->id) //注意 $user->id
        ->first();
    \App\Models\Follow::create([
        'question_id'=>$request->get('question'),
        'user_id'=>$user->id, //注意 $user->id
    ]);
})->middleware('auth:api');

视图

<?php
// resources\views\questions\show.blade.php
// 移除了 user="{{Auth::id()}}
<question-follow-button question="{{$question->id}}"></question-follow-button>

编译

yarn run prod

21.4 优化路由

https://d.laravel-china.org/docs/5.5/eloquent-relationships#updating-many-to-many-relationships

<?php
// routes\api.php
Route::post('/question/follower',function (Request $request){
    $user = Auth::guard('api')->user();
    // 原路由需要提供 user_id ，优化后将 Follow::where 封装成 $user->followed
    //  $followed = \App\Models\Follow::where('question_id',$request->get('question'))
    //   ->where('user_id',$user->id)
    //   ->count();
    $followed = $user->followed($request->get('question'));
    if ($followed) {
        return response()->json(['followed' => true]);
    }
    return response()->json(['followed' => false]);

})->middleware('auth:api');

Route::post('/question/follow',function (Request $request){
    $user = Auth::guard('api')->user();
    $question_id =  $request->get('question');
    // 原路由需要提供 user_id ，优化后将 Follow::where 封装成 $user->followThis
    // followThis 这里用到了 toggle 特性，省去了 Follow::create 步骤
    // $followed = \App\Models\Follow::where('question_id',$question_id)
    //    ->where('user_id',$user->id)
    //    ->first();
    $question = \App\Models\Question::find($question_id);
    $followed = $user->followThis($question_id);
    if (count($followed['detached']) > 0){
        $question->decrement('followers_count');
        return response()->json(['followed' => false]);
    }
    $question->increment('followers_count');
    return response()->json(['followed' => true]);

})->middleware('auth:api');

第二十二章关注用户（上）

22.1 新增 followers 表

该表存放关注者 ID 和被关注者 ID

php artisan make:migration create_followers_table --create=followers

<?php
// database/migrations/create_followers_table.php
public function up()
    {
        Schema::create('followers', function (Blueprint $table) {
            $table->increments('id');
            $table->integer('follower_id')->unsigned()->index();
            $table->integer('followed_id')->unsigned()->index();
            $table->timestamps();
        });
    }

php artisan migrate

一个用户（follower）既可以关注多个用户（正在关注他人，即following），也能被多个用户（关注者，followers）所关注。

<?php
// app\Models\User.php

// 用户（follower）关注了哪些人（followed）
public function following()
{
    // 用户（follower） 和已经关注的人（followed）均在 user 表，故self::class
    // 顺序：类 -- 中间表 -- 用户在中间表的外键 -- 已经关注的人在中间表的外键
    return $this->belongsToMany(self::class, 'followers', 'follower_id', 'followed_id')->withTimestamps();
}

22.2 视图

<?php
// resources/views/questions/show.blade.php
<div class="container">
    <div class="row">
        ......
        <!-- start -->
        <div class="col-md-3">
            <div class="panel panel-default">
                <div class="panel-heading question-follow">
                    <h5>关于作者</h5>
                </div>
                <div class="panel-body">
                    <div class="media">
                        <div class="media-left">
                            <a href="#">
                                <img width="36" src="{{ url('images',$question->user->avatar) }}" alt="{{$question->user->name}}">
                            </a>
                        </div>
                        <div class="media-body">
                            <h4 class="media-heading"><a href="">
                                    {{ $question->user->name }}
                                </a>
                            </h4>
                        </div>
                        <div class="user-statics" >
                            <div class="statics-item text-center">
                                <div class="statics-text">问题</div>
                                <div class="statics-count">{{ $question->user->questions_count }}</div>
                            </div>
                            <div class="statics-item text-center">
                                <div class="statics-text">回答</div>
                                <div class="statics-count">{{ $question->user->answers_count }}</div>
                            </div>
                            <div class="statics-item text-center">
                                <div class="statics-text">关注者</div>
                                <div class="statics-count">{{ $question->user->followers_count }}</div>
                            </div>
                        </div>
                    </div>
                    <user-follow-button user="{{$question->user_id}}"></user-follow-button>
                    <send-message user="{{$question->user_id}}"></send-message>
                </div>
            </div>
        </div>
        <!-- end -->
    </div>
</div>

第二十三章关注用户（下）

23.1 vuejs 组件

这个按钮在关注用户（上）已经添加了

<?php
// resources/views/questions/show.blade.php
<user-follow-button user="{{$question->user_id}}"></user-follow-button>

所以，直接新增 UserFollowButton.vue

// resources\assets\js\components\UserFollowButton.vue
// 页面载入时就向 /api/user/followers/ 发起get请求，查询是否关注了该问题的作者。
// 点击按钮时向 /api/user/follow 发起post请求，直接关注该问题的作者。
<template>
    <button
            class="btn btn-default"
            v-bind:class="{'btn-success': followed}"
            v-text="text"
            v-on:click="follow"
    ></button>
</template>

<script>
    export default {
        props:['user'],
        mounted() {
            axios.get('/api/user/followers/' + this.user).then(response => {
                this.followed = response.data.followed
            })
        },
        data() {
            return {
                followed: false
            }
        },
        computed: {
            text() {
                return this.followed ? '已关注' : '关注他'
            }
        },
        methods:{
            follow() {
                axios.post('/api/user/follow',{'user':this.user}).then(response => {
                    this.followed = response.data.followed
                })
            }
        }
    }
</script>

运行

// resources\assets\js\app.js
Vue.component('user-follow-button', require('./components/UserFollowButton.vue'));

yarn run dev

23.2 路由

<?php
// routes\api.php
//  这里的ID是该问题的作者ID 
Route::get('/user/followers/{id}','FollowersController@index');
Route::post('/user/follow','FollowersController@follow');

23.3 控制器

UserRepository

<?php
namespace App\Repositories;
use App\Models\User;
class UserRepository
{
    public function byId($id)
    {
        return User::find($id);
    }
}

新增 FollowersController 控制器

# 控制器是复数
php artisan make:controller FollowersController

<?php
//app\Http\Controllers\FollowersController.php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Repositories\UserRepository;
use Auth;
class FollowersController extends Controller
{
    protected $user;

    public function __construct(UserRepository $user)
    {
        $this->user = $user;
    }

    public function index($id)
    {
        $user = $this->user->byId($id);
        $followers = $user->followers()->pluck('follower_id')->toArray();
        if ( in_array(Auth::guard('api')->user()->id, $followers) ) {
            return response()->json(['followed' => true]);
        }
        return response()->json(['followed' => false]);
    }

    public function follow()
    {
        $user = $this->user->byId(request('user'));
        $followed = Auth::guard('api')->user()->follow($user->id);
        if ( count($followed['attached']) > 0 ) {
            $user->increment('followers_count');
            return response()->json(['followed' => true]);
        }
        $user->decrement('followers_count');
        return response()->json(['followed' => false]);
    }
}

23.4 用户模型

<?php
// app\Models\User.php

public function following()
{
    return $this->belongsToMany(self::class, 'followers', 'follower_id', 'followed_id')->withTimestamps();
}

// 用户（follower）被哪些人（followed）所关注（关注者）
public function followers()
{
    return $this->belongsToMany(self::class, 'followers', 'followed_id', 'follower_id')->withTimestamps();
}

// 根据用户id发起关注
public function follow($user)
{
    return $this->following()->toggle($user);
}

第二十四章站内信通知

https://laravel-china.org/docs/laravel/5.5/notifications

点击关注后发送通知

<?php
// app\Http\Controllers\FollowersController.php
use App\Notifications\NewUserFollowNotification;
public function follow()
{
    if ( count($followed['attached']) > 0 ) {
        //......
        $user->notify(new NewUserFollowNotification());
    }
}

生成 notification 通知类

php artisan make:notification NewUserFollowNotification
php artisan notifications:table
php artisan migrate

<?php
// app\Notifications\NewUserFollowNotification.php
use Auth;
public function via($notifiable)
{
    return ['database'];
}

public function toDatabase($notifiable)
{
    return [
        'name' => Auth::guard('api')->user()->name,
    ];
}

web 路由

<?php
// routes\web.php
Route::get('notifications','NotificationsController@index');

控制器

php artisan make:controller NotificationsController

<?php
// app\Http\Controllers\NotificationsController.php
use Auth;
public function index()
{
    $user = Auth::user();

    return view('notifications.index', compact('user'));
}

视图

<?php
// resources\views\notifications\index.blade.php
@extends('layouts.app')

@section('content')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
                <div class="panel panel-default">
                    <div class="panel-heading">消息通知</div>
                    <div class="panel-body">
                        @foreach($user->notifications as $notification)
                            @include('notifications.'.snake_case(class_basename($notification->type)))
                        @endforeach
                    </div>
                </div>
            </div>
        </div>
    </div>
@endsection

<?php
// resources\views\notifications\new_user_follow_notification.blade.php
<li class="notifications {{ $notification->unread() ? 'unread' : ' ' }}">
    <a href="{{ $notification->data['name'] }}">
        {{ $notification->data['name'] }}
    </a> 关注了你。
</li>

第二十五章关注用户之邮件通知

25.1 Sendcloud 邮件服务

<?php
// app\Notifications\NewUserFollowNotification.php
use App\Channels\SendcloudChannel;
use Mail;
public function via($notifiable)
{
    return ['database', SendcloudChannel::class];
}

public function toSendcloud($notifiable)
{
    $data = [
        'yourName' => $notifiable->name,
        'followerName' => Auth::guard('api')->user()->name,
        'url'  => 'http://zhihu.dev/user/'.Auth::guard('api')->user()->id,
    ];
    Mail::send('emails.follow', $data, function ($message) use ($data,$notifiable) {
        $message->from('service@sc.mail.wangyan.org', env('APP_NAME','Laravel'));
        $message->to($notifiable->email);
        $message->subject($data['followerName'].'关注了你');
    });
}

<?php
// app\Channels\SendcloudChannel.php
namespace App\Channels;
use Illuminate\Notifications\Notification;
class SendcloudChannel
{
    public function send($notifiable, Notification $notification)
    {
        $message = $notification->toSendcloud($notifiable);
    }
}

视图略

resources/views/emails/follow.blade.php

25.2 Directmail 邮件服务

<?php
// .env
MAIL_DRIVER=sendcloud
SEND_CLOUD_USER=wang_yan
SEND_CLOUD_KEY=ZN1XDQ8q6jRfS3JU

<?php
// app\Notifications\NewUserFollowNotification.php
use App\Channels\DirectmailChannel;
use Mail;
public function via($notifiable)
{
    return ['database', DirectmailChannel::class];
}

public function toDirectmail($notifiable)
{
    $data = [
        'yourName' => $notifiable->name,
        'followerName' => Auth::guard('api')->user()->name,
        'url'  => 'http://zhihu.dev/user/'.Auth::guard('api')->user()->id,
    ];
    Mail::send('emails.follow', $data, function ($message) use ($data,$notifiable) {
        $message->from('service@dm.mail.wangyan.org', env('APP_NAME','Laravel'));
        $message->to($notifiable->email);
        $message->subject($data['followerName'].'关注了你');
    });
}

<?php
// app\Channels\DirectmailChannel.php
namespace App\Channels;
use Illuminate\Notifications\Notification;
class DirectmailChannel
{
    public function send($notifiable, Notification $notification)
    {
        $message = $notification->toDirectmail($notifiable);
    }
}

第二十六章重构邮件通知代码

创建基类

<?php
// app/Mailer/Mailer.php
namespace App\Mailer;
use Illuminate\Support\Facades\Mail;
use Naux\Mail\SendCloudTemplate;
class Mailer
{
    public function sendTo($template, $email, array $data)
    {
        $content = new SendCloudTemplate($template,$data);

        Mail::raw($content,  function ($message) use ($email) {
            $message->from('service@sc.mail.wangyan.org', env('APP_NAME','Laravel'));
            $message->to($email);
        });
    }
}

关注通知

<?php
// app/Mailer/UserMailer.php
namespace App\Mailer;
use Auth;
class UserMailer extends Mailer
{
    public function followNotifyEmail($email,$name)
    {
        $data = [
            'yourName' => $name,
            'followerName' => Auth::guard('api')->user()->name,
            'url'  => 'http://zhihu.dev/user/'.Auth::guard('api')->user()->id,
        ];

        $this->sendTo('zhihu_new_user_follow',$email,$data);
    }
}

<?php
// app/Notifications/NewUserFollowNotification.php
public function toSendcloud($notifiable)
{
    (new UserMailer())->followNotifyEmail($notifiable->email,$notifiable->name);
}

密码重置

<?php
// app/Mailer/UserMailer.php
class UserMailer extends Mailer
{
    public function passwordReset($name,$email,$token)
    {
        $data = [
            'title' => env('APP_NAME','Laravel'),
            'name'  => $name,
            'url'   => url('password/reset',$token)
        ];

        $this->sendTo('zhihu_password_reset',$email,$data);
    }
}

<?php
// app/Models/User.php
public function sendPasswordResetNotification($token)
{
    (new UserMailer())->passwordReset($this->name,$this->email,$token);
}

新用户注册邮件验证

<?php
// app/Mailer/UserMailer.php
class UserMailer extends Mailer
{
    public function verifyEmail($name,$email,$confirmation_token)
    {
        $data = [
            'name' => $name,
            'url'  => Route('email.verify',['token' => $confirmation_token])
        ];

        $this->sendTo('zhihu_user_register',$email,$data);
    }
}

<?php
// app/Http/Controllers/Auth/RegisterController.php
private function sendVerifyEmailTo($user)
{
    (new UserMailer())->verifyEmail($user->name,$user->email,$user->confirmation_token);
}

第二十七章对答案进行点赞

模型

php artisan make:model Vote -m

<?php
// database/migrations/create_votes_table.php
Schema::create('votes', function (Blueprint $table) {
    $table->increments('id');
    $table->unsignedInteger('user_id')->index();
    $table->unsignedInteger('answer_id')->index();
    $table->timestamps();
});

php artisan migrate

路由

<?php
// 都是post
Route::post('/answer/{id}/votes/users','VotesController@users');
Route::post('/answer/vote','VotesController@vote');

控制器

php artisan make:controller VotesController

<?php
// app/Http/Controllers/VotesController.php
namespace App\Http\Controllers;
use App\Repositories\AnswerRepository;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;

class VotesController extends Controller
{
    // AnswerRepository
    protected $answer;
    public function __construct(AnswerRepository $answer)
    {
        $this->answer = $answer;
    }
    
    //根据用户id查询是否已经点赞
    public function users($id)
    {
        $user = Auth::guard('api')->user();
        // hasVoteFor()
        if($user->hasVoteFor($id)){
            return response()->json(['voted' => true]);
        }
        return response()->json(['voted' => false]);
    }

    //点赞
    public function vote()
    {
        // AnswerRepository
        $answer = $this->answer->byId(request('answer'));

        // voteFor()
        $voted = Auth::guard('api')->user()->voteFor(request('answer'));
        if ( count($voted['attached']) > 0 ) {
            $answer->increment('votes_count');
            return response()->json(['voted' => true]);
        }
        $answer->decrement('votes_count');
        return response()->json(['voted' => false]);
    }
}

AnswerRepository

<?php
public function byId($id)
{
    return Answer::find($id);
}

user 模型

<?php
// app/Models/User.php
    // 一个用户可以点赞多个问题，一个问题可以被多个用户点赞，中间表是votes
    public function votes()
    {
        return $this->belongsToMany(Answer::class,'votes');
    }

    /**
     * @param $answer
     * @return array
     */
    public function voteFor($answer)
    {
        return $this->votes()->toggle($answer);
    }

    /**
     * 根据回答id查询是否有点赞记录
     *
     * @param $answer
     * @return bool
     */
    public function hasVoteFor($answer)
    {
        return !! $this->votes()->where('answer_id',$answer)->count();
    }

vuejs组件

<template>
    <button
            class="btn btn-default"
            v-bind:class="{'btn-primary': voted}"
            v-text="text"
            v-on:click="vote"
    ></button>
</template>

<script>
    export default {
        props:['answer','count'],
        mounted() {
            axios.post('/api/answer/' + this.answer + '/votes/users').then(response => {
                this.voted = response.data.voted
            })
        },
        data() {
            return {
                voted: false
            }
        },
        computed: {
            text() {
                return this.count
            }
        },
        methods:{
            vote() {
                axios.post('/api/answer/vote',{'answer':this.answer}).then(response => {
                    this.voted = response.data.voted
                    response.data.voted ? this.count ++ : this.count --
                })
            }
        }
    }
</script>

视图

<?php
<user-vote-button answer="{{$answer->id}}" count="{{$answer->votes_count}}"></user-vote-button>

运行

yarn run dev

第二十八章私信功能（上）

创建数据表

php artisan make:model Modles\\Message -m

<?php
public function up()
    {
        Schema::create('messages', function (Blueprint $table) {
            $table->increments('id');
            $table->unsignedInteger('from_user_id');
            $table->unsignedInteger('to_user_id');
            $table->text('body');
            $table->string('has_read',8)->default('F');
            $table->timestamp('read_at')->nullable();
            $table->timestamps();
        });
    }

php artisan migrate

文档：《Eloquent：关联》

私信模型

<?php
// app/Models/Message.php
class Message extends Model
{
    protected $table = 'messages';
    protected $fillable = ['from_user_id', 'to_user_id', 'body'];

    protected function fromUser()
    {
        // 反向一对一，私信由某个用户发送的
        return $this->belongsTo(User::class,'from_user_id');
    }

    public function toUser()
    {
        // 反向一对多，私信可以发送给多个用户
        return !! $this->belongsTo(User::class,'to_user_id');
    }
}

用户模型

<?php
// app/Models/User.php
    public function messages()
    {
        //用户可以向多个用户发送私信
        return $this->hasMany(Message::class,'to_user_id');
    }

第二十九章私信功能（下）

路由

<?php
// routes/api.php
Route::post('/message/store','MessagesController@store');

私信控制器

php artisan make:controller MessagesController

<?php
namespace App\Http\Controllers;

use App\Repositories\MessageRepository;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;

class MessagesController extends Controller
{
    protected $message;
    public function __construct(MessageRepository $message)
    {
        $this->message = $message;
    }

    public function store()
    {
        $message = $this->message->create([
            'to_user_id' => request('user'),
            'from_user_id' => Auth::guard('api')->user()->id,
            'body' => request('body')
        ]);

        if ($message) {
            return response()->json(['status' => true]);
        }

        return response()->json(['status' => false]);
    }
}

MessageRepository

<?php
// /app/Repositories/MessageRepository.php
namespace App\Repositories;
use App\Models\Message;
class MessageRepository
{
    public function create(array $attributes)
    {
        return Message::create($attributes);
    }
}

视图

<?php
// resources/views/questions/show.blade.php
<send-message user="{{$question->user_id}}"></send-message>

vuejs 组件

Vue.component('send-message', require('./components/SendMessage.vue'));

<!-- resources/assets/js/components/SendMessage.vue -->
<template>
    <div>

    <button
            class="btn btn-default pull-right"
            style="margin-top: -36px;"
            @click="showSendMessageForm"
    >发送私信</button>
        <div class="modal fade" id="modal-send-message" tabindex="-1" role="dialog">
            <div class="modal-dialog">
                <div class="modal-content">
                    <div class="modal-header">
                        <button type="button " class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
                        <h4 class="modal-title">
                            发送私信
                        </h4>
                    </div>
                    <div class="modal-body">
                        <textarea name="body" class="form-control" v-model="body" v-if="!status"></textarea>
                        <div class="alert alert-success" v-if="status">
                            <strong>私信发送成功</strong>
                        </div>
                    </div>
                    <div class="modal-footer">
                        <button type="button" class="btn btn-primary" @click="store">
                            发送私信
                        </button>
                        <button type="button" class="btn btn-default" data-dismiss="modal">关闭</button>
                    </div>
                </div>
            </div>
        </div>
    </div>
</template>

<script>
    export default {
        props:['user'],
        data() {
            return {
                body:'',
                status: false
            }
        },
        methods:{
            store() {
                axios.post('/api/message/store',{'user':this.user,'body':this.body}).then(response => {
                    this.status = response.data.status
                    this.body = ''
                    setTimeout(function () {
                        $('#modal-send-message').modal('hide')
                    }, 2000)
                })
            },
            showSendMessageForm() {
                $('#modal-send-message').modal('show')
            }
        }
    }
</script>

运行

yarn run dev

第三十章实现评论（上）

创建数据表

php artisan make:model Models\\Comment -m

<?php
// database/migrations/create_comments_table.php
// commentable_id 和 commentable_type 用于多态关联
public function up()
    {
        Schema::create('comments', function (Blueprint $table) {
            $table->increments('id');
            $table->unsignedInteger('user_id');
            $table->text('body');
            $table->unsignedInteger('commentable_id');
            $table->string('commentable_type');
            $table->unsignedInteger('parent_id')->nullable();
            $table->smallInteger('level')->default(1);
            $table->string('is_hidden',8)->default('F');
            $table->timestamps();
        });
    }

php artisan migrate

多态关联

文档：《多态关联》

<?php
// app/Models/Comment.php
namespace App\Models;
use Illuminate\Database\Eloquent\Model;
class Comment extends Model
{
    protected $table = 'comments';
    protected $fillable = ['user_id', 'body', 'commentable_id', 'commentable_type'];
    // 获得拥有此评论的模型
    public function commentable()
    {
        return $this->morphTo();
    }
}

获得答案的所有评论

<?php
// app/Models/Answer.php
public function comments()
{
    return $this->morphMany('App\Models\Comment','commentable');
}

获得问题的所有评论

<?php
// app/Models/Question.php
public function comments()
{
    return $this->morphMany('App\Models\Comment','commentable');
}

第三十一章 Vuejs 实现评论组件

路由

<?php
// routes/api.php
Route::get('/answer/{id}/comments','CommentsController@answer');
Route::get('/question/{id}/comments','CommentsController@question');

Route::post('comment','CommentsController@store');

控制器

php artisan make:controller CommentsController

获取多态关联

文档：《Eloquent 预加载》

<?php
// app/Http/Controllers/CommentsController.php
namespace App\Http\Controllers;
use App\models\Answer;
use App\Models\Comment;
use App\Models\Question;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;

class CommentsController extends Controller
{
    // 获取答案所以评论
    public function answer($id)
    {
        $answer = Answer::with('comments','comments.user')->where('id', $id)->first();
        return $answer->comments;
    }

    // 获取问题所有评论
    public function question($id)
    {
        $question = Question::with('comments','comments.user')->where('id', $id)->first();
        return $question->comments;

    }

    // 保存评论
    public function store()
    {
        $model = $this->getModelNameFromType(request('type'));
        $comment = Comment::create([
            'commentable_id' => request('model'),
            'commentable_type' => $model,
            'user_id' => Auth::guard('api')->user()->id,
            'body' => request('body')
        ]);
        return $comment;
    }

    private function getModelNameFromType($type)
    {
        return $type === 'question' ? 'App\Models\Question' : 'App\Models\Answer';
    }
}

vuejs

<!-- resources/assets/js/components/Comments.vue -->
<template>
    <div>

        <button
                class="button is-naked delete-button"
                @click="showCommentsForm"
                v-text="text"
        ></button>
        <div class="modal fade" :id=dialog tabindex="-1" role="dialog">
            <div class="modal-dialog">
                <div class="modal-content">
                    <div class="modal-header">
                        <button type="button " class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
                        <h4 class="modal-title">
                            评论列表
                        </h4>
                    </div>
                    <div class="modal-body">
                       <div v-if="comments.length > 0">
                           <div class="media" v-for="comment in comments">
                               <div class="media-left">
                                   <a href="#">
                                       <img width="24" class="media-object" :src="'http://zhihu.test/images/' + comment.user.avatar">
                                   </a>
                               </div>
                               <div class="media-body">
                                   <h4 class="media-heading">{{comment.user.name}}</h4>
                                   {{comment.body}}
                               </div>
                           </div>
                       </div>
                    </div>
                    <div class="modal-footer">
                        <input type="text" class="form-control" v-model="body">
                        <button type="button" class="btn btn-primary" @click="store">
                            评论
                        </button>
                    </div>
                </div>
            </div>
        </div>
    </div>
</template>

<script>
    export default {
        props:['type','model','count'],
        data() {
            return {
                body:'',
                comments: []
            }
        },
        computed:{
            dialog() {
                return 'comments-dialog-' + this.type + '-' + this.model
            },
            dialogId() {
                return '#' + this.dialog
            },
            text() {
                return this.count + '评论'
            },
            total() {
                return this.count
            }
        },
        methods:{
            store() {
                axios.post('/api/comment',{'type':this.type,'model':this.model,'body':this.body}).then(response => {
                    let comment = {
                        user:{
                            name:Zhihu.name,
                            avatar:Zhihu.avatar
                        },
                        body: response.data.body
                    }
                    this.comments.push(comment)
                    this.body = ''
                    this.total ++
                })
            },
            showCommentsForm() {
                this.getComments()
                $(this.dialogId).modal('show')
            },
            getComments() {
                axios.get('/api/' + this.type +'/' + this.model + '/comments').then(response => {
                    this.comments = response.data
                })
            }
        }
    }
</script>

vuejs 组件

Vue.component('comments', require('./components/Comments.vue'));

视图

<?php
// resources/views/questions/show.blade.php
<comments type="question"
    model="{{$question->id}}"
    count="{{$question->comments()->count()}}">
</comments>
// ......
@foreach($question->answers as $answer)
    // ......
    <comments type="answer"
        model="{{$answer->id}}"
        count="{{$answer->comments()->count()}}">
    </comments>
    // ......
@endforeach

由前端传入用户名和头像

<?php
// resources/views/layouts/app.blade.php
    <script>
        @if(Auth::check())
            window.Zhihu = {
                name:"{{Auth::user()->name}}",
                avatar:"{{Auth::user()->avatar}}"
            }
        @endif
    </script>

第三十二章 Repository 模式重构代码

<?php
// app/Http/Controllers/CommentsController.php
namespace App\Http\Controllers;

use App\Repositories\AnswerRepository;
use App\Repositories\CommentRepository;
use App\Repositories\QuestionsRepository;
use Illuminate\Support\Facades\Auth;

class CommentsController extends Controller
{
    protected $answer;
    protected $question;
    protected $comment;

    public function __construct(AnswerRepository $answer, QuestionsRepository $question, CommentRepository $comment)
    {
        $this->answer = $answer;
        $this->question = $question;
        $this->comment = $comment;
    }

    public function answer($id)
    {
        return $this->answer->getAnswerCommentsById($id);
    }
    
    public function question($id)
    {
        return $this->question->getQuestionCommentsById($id);
    }

    public function store()
    {
        $model = $this->getModelNameFromType(request('type'));

        return $this->comment->create([
            'commentable_id' => request('model'),
            'commentable_type' => $model,
            'user_id' => Auth::guard('api')->user()->id,
            'body' => request('body')
        ]);
    }

    private function getModelNameFromType($type)
    {
        return $type === 'question' ? 'App\Models\Question' : 'App\Models\Answer';
    }
}

AnswerRepository

<?php
// app/Repositories/AnswerRepository.php
public function getAnswerCommentsById($id)
{
    $answer = Answer::with('comments', 'comments.user')->where('id', $id)->first();
    return $answer->comments;
}

QuestionsRepository

<?php
// app/Repositories/QuestionsRepository.php
public function getQuestionCommentsById($id)
{
    $question = Question::with('comments','comments.user')->where('id',$id)->first();
    return $question->comments;
}

CommentRepository

<?php
// app/Repositories/CommentRepository.php
namespace App\Repositories;
use App\Models\Comment;
class CommentRepository
{
    public function create(array $attributes)
    {
        return Comment::create($attributes);
    }
}

第三十三章自定义 helper

33.1 优化话题路由

<?php
// routes/api.php
Route::get('/topics','TopicsController@index')->middleware('api');

php artisan make:Controller TopicsController

<?php
// app/Http/Controllers/TopicsController.php
namespace App\Http\Controllers;
use App\Repositories\TopicRepository;
use Illuminate\Http\Request;
class TopicsController extends Controller
{
   protected $topics;

   /**
    * TopicsController constructor.
    * @param $topics
    */
   public function __construct(TopicRepository $topics)
   {
       $this->topics = $topics;
   }

   public function index(Request $request)
   {
       return $this->topics->getTopicsForTagging($request);
   }
}

<?php
// app/Repositories/TopicRepository.php
namespace App\Repositories;
use App\Models\Topic;
use Illuminate\Http\Request;
class TopicRepository
{
   public function getTopicsForTagging(Request $request)
   {
       return Topic::select(['id','name'])
           ->where('name','like','%'.$request->query('q').'%')
           ->get();
   }
}

33.2 优问题路由

<?php
// routes/api.php
Route::post('/question/follower','QuestionFollowController@follower')->middleware('auth:api');
Route::post('/question/follow','QuestionFollowController@followThisQuestion')->middleware('auth:api');

<?php
// app/Http/Controllers/QuestionFollowController.php
public function follower(Request $request)
   {
       $user = Auth::guard('api')->user();
       $followed = $user->followed($request->get('question'));
       if ($followed) {
           return response()->json(['followed' => true]);
       }
       return response()->json(['followed' => false]);
   }

public function followThisQuestion(Request $request)
   {
       $user = Auth::guard('api')->user();
       $question = $this->question->byID($request->get('question'));
       $followed = $user->followThis($question->id);
       if (count($followed['detached']) > 0){
           $question->decrement('followers_count');
           return response()->json(['followed' => false]);
       }
       $question->increment('followers_count');
       return response()->json(['followed' => true]);
   }

33.3 Helpers 函数

<?php
// app/Support/Helpers.php
if ( !function_exists('user') ) {
   function user($driver = null)
   {
       if ( $driver ) {
           return app('auth')->guard($driver)->user();
       }

       return app('auth')->user();
   }
}

<?php
// composer.json
"autoload": {
   "files":[
       "app/Support/Helpers.php"
   ]
}

composer dump-autoload

<?php
// 在所有控制器中将
Auth::guard('api')->user();  
// 替换成
user('api')

第三十四章私信列表

路由

<?php
// routes/web.php
Route::get('inbox','InboxController@index');
Route::get('inbox/{userId}','InboxController@show');

控制器

php artisan make:controller InboxController

<?php
// app/Http/Controllers/InboxController.php
namespace App\Http\Controllers;

use App\Models\Message;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Auth;

class InboxController extends Controller 
{
   public function __construct()
   {
       $this->middleware('auth');
   }

   public function index()
   {
       $messages = Auth::user()->messages->groupBy('from_user_id');
       return view('inbox.index',compact('messages'));
   }

   public function show($userId)
   {
       $messages = Message::where('from_user_id',$userId)->get();
       return $messages;
   }
}

视图

<?php
// resources/views/inbox/index.blade.php
@extends('layouts.app')

@section('content')
   <div class="container">
       <div class="row">
           <div class="col-md-8 col-md-offset-2">
               <div class="panel panel-default">
                   <div class="panel-heading">私信列表</div>
                   <div class="panel-body">
                       @foreach($messages as $messageGroup)
                           <div class="media">
                               <div class="media-left">
                                   <a href="#">
                                       <img src="{{ url('images', $messageGroup->first()->fromUser->avatar) }}" width="48" alt="">
                                   </a>
                               </div>
                               <div class="media-body">
                                   <h4 class="media-heading">
                                       <a href="#">
                                           {{ $messageGroup->first()->fromUser->name }}
                                       </a>
                                   </h4>
                                   <p>
                                       <a href="/inbox/{{ $messageGroup->first()->fromUser->id }}">
                                           {{ $messageGroup->first()->body }}
                                       </a>
                                   </p>
                               </div>
                           </div>
                       @endforeach
                   </div>
               </div>
           </div>
       </div>
   </div>
@endsection

第三十五章私信列表（下）

解决发件人看不到已发私信

改造数据表

php artisan make:migration add_dialog_id_to_messages --table=messages

<?php
// database/migrations/add_dialog_id_to_messages.php
    public function up()
    {
        Schema::table('messages', function (Blueprint $table) {
            $table->bigInteger('dialog_id')->default('24');
        });
    }

    public function down()
    {
        Schema::table('messages', function (Blueprint $table) {
            $table->dropColumn(['dialog_id']);
        });
    }

<?php
// app/Models/Message.php
protected $fillable = ['from_user_id', 'to_user_id', 'body', 'dialog_id'];

<?php
// app/Http/Controllers/MessagesController.php
public function store()
{
    $message = $this->message->create([
        // ......
        'dialog_id' => time().Auth::id()
    ]);
}

控制器

<?php
// app/Http/Controllers/InboxController.php
   public function index()
   {
       $messages = Message::where('to_user_id',Auth::id())
           ->orWhere('from_user_id',Auth::id())
           ->with(['fromUser','toUser'])->get();
       return view('inbox.index',['messages' => $messages->groupBy('to_user_id')]);
   }

   public function show($dialogId)
   {
       $messages = Message::where('dialog_id',$dialogId)->get();
       return $messages;
   }

路由

<?php
// routes/web.php
Route::get('inbox/{dialogId}','InboxController@show');

视图

Auth::id() == $key

按收件人分组后，如果当前登陆用户就是收件人，则显示发件人信息，否则显示收件人信息。

<?php
@extends('layouts.app')

@section('content')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
                <div class="panel panel-default">
                    <div class="panel-heading">私信列表</div>
                    <div class="panel-body">
                        @foreach($messages as $key => $messageGroup)
                            <div class="media">
                                <div class="media-left">
                                    <a href="#">
                                        @if(Auth::id() == $key)
                                            <img src="{{ url('images', $messageGroup->last()->fromUser->avatar) }}" width="48" alt="">
                                        @else
                                            <img src="{{ url('images', $messageGroup->last()->toUser->avatar) }}" width="48" alt="">
                                        @endif
                                    </a>
                                </div>
                                <div class="media-body">
                                    <h4 class="media-heading">
                                        <a href="#">
                                            @if(Auth::id() == $key)
                                                {{ $messageGroup->last()->fromUser->name }}
                                            @else
                                                {{ $messageGroup->last()->toUser->name }}
                                            @endif
                                        </a>
                                    </h4>
                                    <p>
                                        <a href="/inbox/{{ $messageGroup->last()->dialog_id }}">
                                            {{ $messageGroup->last()->body }}
                                        </a>
                                    </p>
                                </div>
                            </div>
                        @endforeach
                    </div>
                </div>
            </div>
        </div>
    </div>
@endsection

第三十六章回复私信

路由

<?php
// routes/web.php
Route::post('inbox/{dialogId}/store','InboxController@store');

<?php
// app/Http/Controllers/InboxController.php
<?php
   public function index()
   {
       $messages = Message::where('to_user_id',Auth::id())
           ->orWhere('from_user_id',Auth::id())
           ->with(['fromUser','toUser'])->get();
       return view('inbox.index',['messages' => $messages->unique('dialog_id')->groupBy('to_user_id')]);
   }

   public function show($dialogId)
   {
       $messages = Message::where('dialog_id',$dialogId)->latest()->get();
       return view('inbox.show',compact('messages','dialogId'));
   }

   public function store($dialogId)
   {
       $message = Message::where('dialog_id',$dialogId)->first();
       $toUserId = $message->from_user_id === Auth::id() ? $message->to_user_id : $message->from_user_id;
       Message::create([
           'from_user_id' => Auth::id(),
           'to_user_id' => $toUserId,
           'body' => request('body'),
           'dialog_id' => $dialogId
       ]);
       return back();
   }
}

视图

<?php
// resources/views/inbox/show.blade.php
@extends('layouts.app')

@section('content')
   <div class="container">
       <div class="row">
           <div class="col-md-8 col-md-offset-2">
               <div class="panel panel-default">
                   <div class="panel-heading">对话列表</div>
                   <div class="panel-body">
                       <form action="/inbox/{{$dialogId}}/store" method="post">
                           {{ csrf_field() }}
                           <div class="form-group">
                               <textarea name="body" class="form-control"></textarea>
                           </div>
                           <div class="form-group pull-right">
                               <button class="btn btn-success">发送私信</button>
                           </div>
                       </form>
                       <div class="messages-list">
                           @foreach($messages as $message)
                               <div class="media">
                                   <div class="media-left">
                                       <a href="#">
                                           <img src="{{ url('images',$message->fromUser->avatar) }}"  width="48" alt="">
                                       </a>
                                   </div>
                                   <div class="media-body">
                                       <h4 class="media-heading">
                                           <a href="#">
                                               {{ $message->fromUser->name }}
                                           </a>
                                       </h4>
                                       <p>
                                           {{ $message->body }} <span class="pull-right">{{ $message->created_at->format('Y-m-d') }}</span>
                                       </p>
                                   </div>
                               </div>
                           @endforeach
                       </div>
                   </div>
               </div>
           </div>
       </div>
   </div>
@endsection

第三十七章标记私信已读

<?php
// app/Http/Controllers/InboxController.php
public function show($dialogId)
{
   $messages->markAsRead();
}

<?php
// app/Models/Message.php
public function markAsRead()
   {
       if(is_null($this->read_at)) {
           $this->forceFill(['has_read' => 'T','read_at' => $this->freshTimestamp()])->save();
       }
   }

   public function newCollection(array $models = [])
   {
       return new MessageCollection($models);
   }

<?php
// /app/Models/MessageCollection.php
namespace App\Models;
use Illuminate\Database\Eloquent\Collection;
use Illuminate\Support\Facades\Auth;
class MessageCollection extends Collection
{
   public function markAsRead()
   {
       $this->each(function($message) {
           if($message->to_user_id === Auth::id() ){
               $message->markAsRead();
           }
       });
   }
}

第三十八章显示未读私信

<?php
// app/Http/Controllers/InboxController.php
// 根据 dialog_id 会话分组（一个会话有多条私信），倒序（每个会话中最后的私信排最前）。
   public function index()
   {
       $messages = Message::where('to_user_id',Auth::id())
           ->orWhere('from_user_id',Auth::id())
           ->with(['fromUser','toUser'])->latest()->get();
       return view('inbox.index',['messages' => $messages->groupBy('dialog_id')]);
   }

   public function show($dialogId)
   {
       $messages = Message::where('dialog_id',$dialogId)->latest()->get();
       $messages->markAsRead();
       return view('inbox.show',compact('messages','dialogId'));
   }

视图

<?php
// resources/views/inbox/index.blade.php
// 每个会话显示一个列表，如果登陆用户就是发件人，那么显示收件人头像，否则显示发件人头像。
// $messageGroup->first() 指回话中的最后一条私信记录（messages已经倒序）
@extends('layouts.app')

@section('content')
   <div class="container">
       <div class="row">
           <div class="col-md-8 col-md-offset-2">
               <div class="panel panel-default">
                   <div class="panel-heading">私信列表</div>
                   <div class="panel-body">
                       @foreach($messages as $messageGroup)
                           <div class="media {{ $messageGroup->first()->shouldAddUnreadClass() ? 'unread' : '' }}">
                               <div class="media-left">
                                   <a href="#">
                                       @if(Auth::id() == $messageGroup->last()->from_user_id)
                                           <img src="{{ url('images', $messageGroup->last()->toUser->avatar) }}" width="48" alt="">
                                       @else
                                           <img src="{{ url('images', $messageGroup->last()->fromUser->avatar) }}" width="48" alt="">
                                       @endif
                                   </a>
                               </div>
                               <div class="media-body">
                                   <h4 class="media-heading">
                                       <a href="#">
                                           @if(Auth::id() == $messageGroup->last()->from_user_id)
                                               {{ $messageGroup->last()->toUser->name }}
                                           @else
                                               {{ $messageGroup->last()->fromUser->name }}
                                           @endif
                                       </a>
                                   </h4>
                                   <p>
                                       <a href="/inbox/{{ $messageGroup->first()->dialog_id }}">
                                           {{ $messageGroup->first()->body }}
                                       </a>
                                   </p>
                               </div>
                           </div>
                       @endforeach
                   </div>
               </div>
           </div>
       </div>
   </div>
@endsection

模型

<?php
// app/Models/Message.php
   public function read()
   {
       return $this->has_read === 'T';
   }

   public function unread()
   {
       return $this->has_read === 'F';
   }

   public function shouldAddUnreadClass()
   {
       // 如果登陆用户就是发件人，那么始终未读
       if(Auth::id() === $this->from_user_id) {
           return false;
       }
       return $this->unread();
   }

优化

<?php
// app/Http/Controllers/InboxController.php
public function index()
   {
       $messages = Message::where('to_user_id',Auth::id())
           ->orWhere('from_user_id',Auth::id())
           ->with(['fromUser' => function ($query){
               return $query->select(['id','name','avatar']);
           },'toUser' => function ($query){
               return $query->select(['id','name','avatar']);
           }])->latest()->get();
       return view('inbox.index',['messages' => $messages->groupBy('dialog_id')]);
   }
   public function show($dialogId)
   {
       $messages = Message::where('dialog_id',$dialogId)->with(['fromUser' => function ($query){
               return $query->select(['id','name','avatar']);
           },'toUser' => function ($query){
               return $query->select(['id','name','avatar']);
           }])->latest()->get();
       $messages->markAsRead();
       return view('inbox.show',compact('messages','dialogId'));
   }

第三十九章私信实现 Repository 模式

<?php
// app/Repositories/MessageRepository.php
namespace App\Repositories;

use App\Models\Message;
use Illuminate\Support\Facades\Auth;

class MessageRepository
{
    public function create(array $attributes)
    {
        return Message::create($attributes);
    }

    public function getAllMessages()
    {
        return $messages = Message::where('to_user_id',Auth::id())
            ->orWhere('from_user_id',Auth::id())
            ->with(['fromUser' => function ($query){
                return $query->select(['id','name','avatar']);
            },'toUser' => function ($query){
                return $query->select(['id','name','avatar']);
            }])->latest()->get();
    }

    public function getDialogMessagesBy($dialogId)
    {
        return Message::where('dialog_id',$dialogId)->with(['fromUser' => function ($query){
            return $query->select(['id','name','avatar']);
        },'toUser' => function ($query){
            return $query->select(['id','name','avatar']);
        }])->latest()->get();
    }

    public function getStingleMessageBy($dialogId)
    {
        return Message::where('dialog_id',$dialogId)->first();
    }
}

控制器

<?php
// app/Http/Controllers/InboxController.php
namespace App\Http\Controllers;

use App\Repositories\MessageRepository;
use Illuminate\Support\Facades\Auth;

class InboxController extends Controller
{
    protected $message;

    public function __construct(MessageRepository $message)
    {
        $this->middleware('auth');
        $this->message = $message;
    }

    public function index()
    {
        $messages = $this->message->getAllMessages();
        return view('inbox.index',['messages' => $messages->groupBy('dialog_id')]);
    }

    public function show($dialogId)
    {
        $messages = $this->message->getDialogMessagesBy($dialogId);
        $messages->markAsRead();
        return view('inbox.show',compact('messages','dialogId'));
    }

    public function store($dialogId)
    {
        $message = $this->message->getStingleMessageBy($dialogId);
        $toUserId = $message->from_user_id === Auth::id() ? $message->to_user_id : $message->from_user_id;
        $this->message->create([
            'from_user_id' => Auth::id(),
            'to_user_id' => $toUserId,
            'body' => request('body'),
            'dialog_id' => $dialogId
        ]);
        return back();
    }
}

第四十章私信通知

 php artisan make:notification NewMessageNotification

<?php
// app/Notifications/NewMessageNotification.php
namespace App\Notifications;

use App\Models\Message;
use Illuminate\Notifications\Notification;

class NewMessageNotification extends Notification
{
   public $message;

   public function __construct(Message $message)
   {
       $this->message = $message;
   }

   public function via()
   {
       return ['database'];
   }

   public function toDatabase()
   {
        return [
            'name' => $this->message->fromUser->name,
            'dialog' => $this->message->dialog_id,
        ];
   }
}

控制器

<?php
// app/Http/Controllers/InboxController.php
public function store($dialogId)
   {
       $message = $this->message->getStingleMessageBy($dialogId);
       $toUserId = $message->from_user_id === Auth::id() ? $message->to_user_id : $message->from_user_id;
       $newMessage = $this->message->create([
           'from_user_id' => Auth::id(),
           'to_user_id' => $toUserId,
           'body' => request('body'),
           'dialog_id' => $dialogId
       ]);
       $newMessage->toUser->notify(new NewMessageNotification($newMessage));
       return back();
   }

视图

<?php
// resources/views/notifications/new_message_notification.blade.php
<li class="notifications">
   <a href="/inbox/{{$notification->data['dialog']}}">
       {{ $notification->data['name'] }} 给你发了一条私信
   </a>
</li>

第四十一章 notifications 已读

路由

# routes/web.php
Route::get('notifications/{notification}','NotificationsController@show');

控制器

<?php
// app/Http/Controllers/NotificationsController.php
public function show(DatabaseNotification $notification)
   {
       $notification->markAsRead();
       return redirect(\Request::query('redirect_url'));
   }

视图

<?php
// resources/views/notifications/new_message_notification.blade.php
<li class="notifications {{ $notification->unread() ? 'unread' : ' ' }}">
   <a href="/notifications/{{$notification->id}}?redirect_url=https://www.bg7pbp.com/inbox/{{$notification->data['dialog']}}">
       {{ $notification->data['name'] }} 给你发了一条私信
   </a>
</li>

第四十二章上传头像组件

路由

<?php
// routes/web.php
Route::get('avatar','UsersController@avatar');

控制器

php artisan make:controller UsersController

<?php
// app/Http/Controllers/UsersController.php
class UsersController extends Controller
{
   public function avatar()
   {
       return view('users.avatar');
   }
}

视图

<?php
// resources/views/users/avatar.blade.php
@extends('layouts.app')

@section('content')
   <div class="container">
       <div class="row">
           <div class="col-md-8 col-md-offset-2">
               <div class="panel panel-default">
                   <div class="panel-heading">更换头像</div>
                   <div class="panel-body">
                       <user-avatar avatar="{{ url('images',Auth::user()->avatar) }}" ></user-avatar>
                   </div>
               </div>
           </div>
       </div>
   </div>
@endsection

vue 组件

http://github.com/dai-siki/vue-image-crop-upload

yarn add vue-image-crop-upload babel-polyfill

<?php
// /resources/assets/js/app.js
Vue.component('user-avatar', require('./components/Avatar.vue'));

<!-- resources/assets/js/components/Avatar.vue -->
<template>
    <div>
        <my-upload field="img"
                   @crop-success="cropSuccess"
                   @crop-upload-success="cropUploadSuccess"
                   @crop-upload-fail="cropUploadFail"
                   v-model="show"
                   :width="300"
                   :height="300"
                   url="/upload"
                   :params="params"
                   :headers="headers"
                   img-format="png"></my-upload>
        <img :src="imgDataUrl" width="48">
        <a class="btn" @click="toggleShow">设置头像</a>
    </div>
</template>

<script>
    import 'babel-polyfill'; // es6 shim
    import myUpload from 'vue-image-crop-upload';
    export default {
        props:['avatar'],
        data() {
            return {
                show: false,
                params: {
                    token: '123456798',
                    name: 'avatar'
                },
                headers: {
                    smail: '*_~'
                },
                imgDataUrl: this.avatar
            }
        },
        components: {
            'my-upload': myUpload
        },
        methods: {
            toggleShow() {
                this.show = !this.show;
            },
            cropSuccess(imgDataUrl, field){
                console.log('-------- crop success --------');
                this.imgDataUrl = imgDataUrl;
            },
            cropUploadSuccess(jsonData, field){
                console.log('-------- upload success --------');
                console.log(jsonData);
                console.log('field: ' + field);
            },
            cropUploadFail(status, field){
                console.log('-------- upload fail --------');
                console.log(status);
                console.log('field: ' + field);
            }
        }
    }
</script>

yarn run dev

第四十三章头像上传到服务器

路由

<?php
// routes/web.php
Route::get('avatar','UsersController@avatar');

控制器

<?php
// app/Http/Controllers/UsersController.php
public function changeAvatar(Request $request)
   {
       $file = $request->file('img');
       $filename = md5(time().user()->id).'.'.$file->getClientOriginalExtension();
       $file->move(public_path('avatars'),$filename);
       user()->avatar = asset('avatars/'.$filename);
       user()->save();
       return ['url' => user()->avatar];
   }

vue 组件

<!-- resources/assets/js/components/Avatar.vue -->
<template>
    <div style="text-align: center;">
        <my-upload field="img"
                   @crop-success="cropSuccess"
                   @crop-upload-success="cropUploadSuccess"
                   @crop-upload-fail="cropUploadFail"
                   v-model="show"
                   :width="300"
                   :height="300"
                   url="/avatar"
                   :params="params"
                   :headers="headers"
                   img-format="png"></my-upload>
        <img :src="imgDataUrl" style="width: 80px;">
        <div style="margin-top: 20px;">
            <button class="btn btn-default" @click="toggleShow">设置头像</button>
        </div>
    </div>
</template>

<script>
    import 'babel-polyfill';
    import myUpload from 'vue-image-crop-upload';

    export default {
        props:['avatar','token'],
        data() {
            return {
                show: false,
                params: {
                    name: 'img'
                },
                headers: {
                    smail: '*_~',
                    'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content')
                },
                imgDataUrl: this.avatar
            }
        },
        components: {
            'my-upload': myUpload
        },
        methods: {
            toggleShow() {
                this.show = !this.show;
            },
            cropSuccess(imgDataUrl, field){
                this.imgDataUrl = imgDataUrl;
            },
            cropUploadSuccess(response, field){
                this.imgDataUrl = response.url
                this.toggleShow()
            },
            cropUploadFail(status, field){
                console.log('-------- upload fail --------');
                console.log(status);
                console.log('field: ' + field);
            }
        }
    }
</script>

yarn run dev

第四十四章头像上传到七牛

安装扩展包

https://github.com/overtrue/laravel-filesystem-qiniu

composer require "overtrue/laravel-filesystem-qiniu" -vvv

<?php
// config/app.php
'providers' => [
    // Other service providers...
    Overtrue\LaravelFilesystem\Qiniu\QiniuStorageServiceProvider::class,
],

<?php
// config/filesystems.php
return [
   'disks' => [
        //...
        'qiniu' => [
           'driver'     => 'qiniu',
           'access_key' => env('QINIU_ACCESS_KEY', 'xxxxxxxxxxxxxxxx'),
           'secret_key' => env('QINIU_SECRET_KEY', 'xxxxxxxxxxxxxxxx'),
           'bucket'     => env('QINIU_BUCKET', 'test'),
           'domain'     => env('QINIU_DOMAIN', 'xxx.clouddn.com'), // or host: https://xxxx.clouddn.com
        ],
        //...
    ]
];

控制器

<?php
// app/Http/Controllers/UsersController.php
public function changeAvatar(Request $request)
   {
       $file = $request->file('img');
       $filename = 'avatars/'.md5(time().user()->id).'.'.$file->getClientOriginalExtension();

       Storage::disk('qiniu')->writeStream($filename,fopen($file->getRealPath(),'r'));
       user()->avatar = 'http://'.config('filesystems.disks.qiniu.domain').'/'.$filename;

       user()->save();
       return ['url' => user()->avatar];
   }

第四十五章实现修改密码

路由

<?php
// routes/web.php
Route::get('password','PasswordController@password');
Route::post('password/update','PasswordController@update');

验证密码

php artisan make:request ChangePasswordRequest

<?php
// app/Http/Requests/ChangePasswordRequest.php
namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
class ChangePasswordRequest extends FormRequest
{
    public function authorize()
    {
        return true;
    }

    public function rules()
    {
        return [
            'old_password' => 'required|min:6',
            'password' => 'required|min:6|confirmed',
        ];
    }

    public function messages()
    {
        return [
            'old_password.required' => '原始密码不能为空',
            'old_password.min' => '原始密码不能少于6个字符',
            'password.required' => '新始密码不能为空',
            'password.min' => '新密码不能少于6个字符',
            'password.confirmed' => '两次输入新密码不符',
        ];
    }
}

控制器

php artisan make:controller PasswordController

<?php
// app/Http/Controllers/PasswordController.php
namespace App\Http\Controllers;
use Hash;
use App\Http\Requests\ChangePasswordRequest;
class PasswordController extends Controller
{
    public function password()
    {
        return view('users.password');
    }

    public function update(ChangePasswordRequest $request)
    {
        if(Hash::check($request->get('old_password'),user()->password)) {
            user()->password = bcrypt($request->get('password'));
            user()->save();
            flash('密码修改成功','success');
            return back();
        }
        flash('密码修改失败','danger');
        return back();
    }
}

视图

<?php
// resources/views/users/password.blade.php
@extends('layouts.app')

@section('content')
    <div class="container">
        <div class="row">
            <div class="col-md-8 col-md-offset-2">
                <div class="panel panel-default">
                    <div class="panel-heading">修改密码</div>
                    <div class="panel-body">
                        @include('flash::message')
                        <form class="form-horizontal" role="form" method="POST" action="/password/update">
                            {{ csrf_field() }}
                            <div class="form-group{{ $errors->has('old_password') ? ' has-error' : '' }}">
                                <label for="old_password" class="col-md-4 control-label">原始密码</label>
                                <div class="col-md-6">
                                    <input id="old_password" type="password" class="form-control" name="old_password" value="{{ old('old_password') }}" required>
                                    @if ($errors->has('old_password'))
                                        <span class="help-block">
                                        <strong>{{ $errors->first('old_password') }}</strong>
                                    </span>
                                    @endif
                                </div>
                            </div>
                            <div class="form-group{{ $errors->has('password') ? ' has-error' : '' }}">
                                <label for="password" class="col-md-4 control-label">输入新密码</label>
                                <div class="col-md-6">
                                    <input id="password" type="password" class="form-control" name="password" required>
                                    @if ($errors->has('password'))
                                        <span class="help-block">
                                        <strong>{{ $errors->first('password') }}</strong>
                                    </span>
                                    @endif
                                </div>
                            </div>
                            <div class="form-group">
                                <label for="password-confirm" class="col-md-4 control-label">确认新密码</label>
                                <div class="col-md-6">
                                    <input id="password-confirm" type="password" class="form-control" name="password_confirmation" required>
                                </div>
                            </div>
                            <div class="form-group">
                                <div class="col-md-6 col-md-offset-4">
                                    <button type="submit" class="btn btn-primary btn-block">
                                        更改密码
                                    </button>
                                </div>
                            </div>
                        </form>
                    </div>
                </div>
            </div>
        </div>
    </div>
@endsection

第四十六章用户个人设置

路由

<?php
// routes/web.php
Route::get('setting','SettingController@index');
Route::post('setting','SettingController@store');

控制器

php artisan make:controller SettingController

<?php
// app/Http/Controllers/SettingController.php
namespace App\Http\Controllers;

use Illuminate\Http\Request;

class SettingController extends Controller
{
   public function index()
   {
       return view('users.setting');
   }

   public function store(Request $request)
   {
       $settings = array_merge(user()->settings,array_only($request->all(),['city','bio']));
       user()->update(['settings' => $settings]);
       return back();
   }
}

模型

<?php
// app/Models/User.php
protected $fillable = [
   'settings',
];

protected $casts = [
   'settings' => 'array'
];

默认值

<?php
// app/Http/Controllers/Auth/RegisterController.php
$user =  User::create([
   'settings' => ['city' => ''],
]);

视图

<?php
// /resources/views/users/setting.blade.php
@extends('layouts.app')

@section('content')
   <div class="container">
       <div class="row">
           <div class="col-md-8 col-md-offset-2">
               <div class="panel panel-default">
                   <div class="panel-heading">设置个人信息</div>
                   <div class="panel-body">
                       <form class="form-horizontal" role="form" method="POST" action="/setting">
                           {{ csrf_field() }}
                           <div class="form-group{{ $errors->has('city') ? ' has-error' : '' }}">
                               <label for="city" class="col-md-4 control-label">现居城市</label>
                               <div class="col-md-6">
                                   <input id="city" type="text" class="form-control" name="city" value="{{ user()->settings['city'] }}"  required>
                                   @if ($errors->has('city'))
                                       <span class="help-block">
                                       <strong>{{ $errors->first('city') }}</strong>
                                   </span>
                                   @endif
                               </div>
                           </div>
                           <div class="form-group{{ $errors->has('city') ? ' has-error' : '' }}">
                               <label for="bio" class="col-md-4 control-label">个人简介</label>
                               <div class="col-md-6">
                                   <textarea id="bio" type="text" class="form-control" name="bio"  required>{{ user()->settings['bio'] }}</textarea>
                                   @if ($errors->has('bio'))
                                       <span class="help-block">
                                       <strong>{{ $errors->first('bio') }}</strong>
                                   </span>
                                   @endif
                               </div>
                           </div>
                           <div class="form-group">
                               <div class="col-md-6 col-md-offset-4">
                                   <button type="submit" class="btn btn-primary btn-block">
                                       更新资料
                                   </button>
                               </div>
                           </div>
                       </form>
                   </div>
               </div>
           </div>
       </div>
   </div>
@endsection

第四十七章重构用户设置

控制器

<?php
// app/Http/Controllers/SettingController.php
public function store(Request $request)
   {
       user()->settings()->merge($request->all());
       return back();
   }

模型

<?php
// app/Models/User.php
public function settings()
{
   return new Setting($this);
}

<?php
namespace App\Models;
class Setting
{
   protected $allowed = ['city','bio'];
   protected $user;

   public function __construct(User $user)
   {
       $this->user = $user;
   }

   public function merge(array $attributes)
   {
       $settings = array_merge($this->user->settings,array_only($attributes,$this->allowed));

       return $this->user->update(['settings' => $settings]);
   }
}

阿里云邮件推送 Package

Tue, 15 Aug 2017 00:00:00 +0800

邮件推送（DirectMail）是一款简单高效的电子邮件发送服务，它构建在可靠稳定的阿里云基础之上，帮助您快速、精准地实现事务邮件、通知邮件和批量邮件的发送。邮件推送历经两年双11考验，在发送速度、系统稳定性和到达率上表现优异；提供丰富的接口和灵活的使用方式，为企业和开发者解决邮件投递的难题，用户无需自建邮件服务器，开通服务即可享受阿里云优质的邮件服务，获得邮件投递的最佳实践。

DirectMail 官网： https://www.aliyun.com/product/directmail

一、安装方法

项目地址：

https://github.com/wangyan/directmail

在项目目录下执行

composer require wang_yan/directmail:dev-master

二、配置方法

修改 config/app.php，添加服务提供者

<?php
'providers' => [
   // 添加这行
    WangYan\DirectMail\DirectMailTransportProvider::class,
];

在 .env 中配置你的密钥，并修改邮件驱动为 directmail

MAIL_DRIVER=directmail

DIRECT_MAIL_KEY=     # AccessKeyId
DIRECT_MAIL_SECRET=  # AccessSecret

三、基本使用

详细用法请参考 laravel 文档：

http://d.laravel-china.org/docs/5.4/mail

使用演示：

<?php
// routes\web.php
Route::get('/email', function(){
    $data = [
        'url'  => 'https://laravel.com',
        'name' => 'laravel'
    ];

    Mail::send('emails.register', $data, function ($message) {
        $message->from('us@example.com', 'Laravel');
        $message->to('foo@example.com');
        $message->subject('Hello World');
    });
});

编辑邮件模板

<?php
resources\views\emails\register.blade.php

四、简单实例

演示怎样发送注册验证邮件，首先初始化

php artisan make:auth
php artisan migrate

修改 RegisterController 控制器

<?php 
// app\Http\Controllers\Auth\RegisterController.php

    use Illuminate\Support\Facades\Mail;

    protected function create(array $data)
    {
        $user =  User::create([
            'name' => $data['name'],
            'email' => $data['email'],
            'confirmation_token' => str_random(40),
            'password' => bcrypt($data['password']),
        ]);

        $this->sendVerifyEmailTo($user);
        return $user;
    }

    private function sendVerifyEmailTo($user)
    {
        $data = [
            'name' => $user->name,
            'url'  => Route('email.verify',['token' => $user->confirmation_token])
        ];

        Mail::send('emails.register', $data, function ($message) use ($user) {
            $message->from('service@dm.mail.wangyan.org', env('APP_NAME','Laravel'));
            $message->to($user->email);
            $message->subject('请验证您的 Email 地址');
        });
    }

修改 User 模型

<?php 
// app\User.php
    protected $fillable = [
        'name', 'email', 'password','confirmation_token'
    ];

增加邮件模板

vim resources\views\emails\register.blade.php

增加路由

<?php
// routes\web.php
Route::get('/email/verify/{token}', 'EmailController@verify')->name('email.verify');

增加控制器

php artisan make:controller EmailController

编辑控制器

<?php
class EmailController extends Controller
{
    /**
     * @param $token
     * @return \Illuminate\Http\RedirectResponse|\Illuminate\Routing\Redirector
     */
    function verify($token)
    {
        $user = User::where('confirmation_token',$token)->first();

        if(is_null($user)){
            return redirect('/');
        }

        $user->is_active = 1;

        $user->confirmation_token= str_random(40);
        $user->save();

        return redirect('/home');
    }
}

Laravel 5 开发 API 笔记

Tue, 01 Aug 2017 00:00:00 +0800

第1章填充测试数据

1.1 生成数据库表

http://d.laravel-china.org/docs/5.4/migrations

创建数据库表

php artisan make:migration create_lessons_table --create=lessons

创建模型和控制器（这里将模型放到 Models 目录下）

php artisan make:controller LessonController -m Models\\Lesson

修改 migrate

<?php
// database\migrations\2017_07_01_182454_create_lessons_table.php
Schema::create('lessons', function (Blueprint $table) {
    $table->increments('id');
    $table->string('title');
    $table->text('body');
    $table->boolean('free');
    $table->timestamps();
});

解决导入错误

<?php
// app\Providers\AppServiceProvider.php

use Illuminate\Support\Facades\Schema;

public function boot()
{
    Schema::defaultStringLength(191);
}

生成数据表

php artisan migrate

1.2 Eloquent 模型工厂填充数据

http://d.laravel-china.org/docs/5.4/database-testing#writing-factories

修改 ModelFactory.php

<?php
// database\factories\ModelFactory.php
$factory->define(App\Models\Lesson::class, function (Faker\Generator $faker) {
    static $password;

    return [
        'title' => $faker->sentence,
        'body' => $faker->paragraph,
        'free' => $faker->boolean(),
    ];
});

方法一：使用 tinker 生成数据

php artisan tinker
>>>factory(App\Models\Lesson::class,60)->create();
>>> quit

方法二：编写 Seeders 生成数据

http://d.laravel-china.org/docs/5.4/seeding

php artisan make:seeder LessonsTableSeeder

<?php
//  database\seeds\LessonsTableSeeder.php
    public function run()
    {
        factory(App\Lesson::class, 50)->create();
    }

php artisan db:seed --class=LessonsTableSeeder

第2章初步实现 API 系统

2.1 注册路由

http://d.laravel-china.org/docs/5.4/routing

<?php
// routes\api.php
Route::group(['prefix'=>'v1'], function (){
    Route::resource('lesson','LessonController');
});

查看已注册的路由

# 注意这里不是 api:route
php artisan route:list

2.2 编辑控制器

http://d.laravel-china.org/docs/5.4/controllers
http://d.laravel-china.org/docs/5.4/eloquent

<?php
// app\Http\Controllers\LessonController.php
    public function index()
    {
        return Lesson::all();
    }

    public function show(Lesson $lesson)
    {
        // 旧版本
        //return Lesson::findOrfail($id);
        return $lesson;
    }

访问：http://api.dev/api/v1/lesson 和 http://api.dev/api/v1/lesson/1

第3章 API 字段映射

3.1 附加状态到 Response 响应

http://d.laravel-china.org/docs/5.4/responses

<?php
// app\Http\Controllers\LessonController.php
    public function index()
    {
        return \Response::json([
            'status'=>'Success',
            'status_code'=>'200',
            'data'=>Lesson::all()->toArray()
        ]);
    }

    public function show(Lesson $lesson)
    {
        return \Response::json([
            'status'=>'Success',
            'status_code'=>'200',
            'data'=>$lesson->toArray()
        ]);
    }

3.2 隐藏数据库字段结构

http://php.net/manual/zh/function.array-map.php

<?php
// app\Http\Controllers\LessonController.php
    public function index()
    {
        $lessons = Lesson::all();
        return \Response::json([
            'status'=>'Success',
            'status_code'=>'200',
            'data'=>$this->transformCollection($lessons)
        ]);
    }

    public function show(Lesson $lesson)
    {
        return \Response::json([
            'status'=>'Success',
            'status_code'=>'200',
            'data'=>$this->transform($lesson->toArray())
        ]);
    }
    
    public function transformCollection($lessons)
    {
        return array_map([$this, 'transform'],$lessons->toArray());
    }

    public function transform($lessons)
    {
        return [
            'title'=>$lessons['title'],
            'content'=>$lessons['body'],
            'is_free'=>(boolean) $lessons['free']
        ];
    }

第4章重构 API 代码

<?php
// app\Transformer\LessonTransfromer.php
namespace App\Transformer;

class LessonTransfromer extends Transformer
{
    public function transform($lessons)
    {
        return [
            'title'=>$lessons['title'],
            'content'=>$lessons['body'],
            'is_free'=>(boolean) $lessons['free']
        ];
    }
}

<?php
// app\Transformer\Transformer.php
namespace App\Transformer;

abstract class Transformer
{
    public function transformCollection($items)
    {
        return array_map([$this, 'transform'],$items->toArray());
    }

    public abstract function transform($items);
}

<?php
// app\Http\Controllers\LessonController.php
use App\Transformer\LessonTransfromer;

class LessonController extends Controller
{
    protected $lessonTransfromer;

    // 依赖注入
    public function __construct(LessonTransfromer $lessonTransfromer)
    {
        $this->lessonTransfromer = $lessonTransfromer;
    }

    public function index()
    {
        $lessons = Lesson::all();
        return \Response::json([
            'status'=>'Success',
            'status_code'=>'200',
            'data'=>$this->lessonTransfromer->transformCollection($lessons)
        ]);
    }

    public function show(Lesson $lesson)
    {
        return \Response::json([
            'status'=>'Success',
            'status_code'=>'200',
            'data'=>$this->lessonTransfromer->transform($lesson->toArray())
        ]);
    }
}

第5章处理错误返回

http://d.laravel-china.org/docs/5.4/errors

生成 ApiController

php artisan make:controller ApiController

<?php
// App\Http\Controllers\ApiController
class ApiController extends Controller
{

    protected $statusCode = 200;

    public function getStatusCode()
    {
        return $this->statusCode;
    }

    public function setStatusCode($statusCode)
    {
        $this->statusCode = $statusCode;
        return $this;
    }

    public function responseNotFound($message = 'Not Found')
    {
        return $this->setStatusCode(404)->responseError($message);
    }

    public function responseError($message)
    {
        return $this->response([
            'status'=>'failed',
            'error'=>[
                'status_code'=>$this->getStatusCode(),
                'message'=>$message
            ]
        ]);
    }

    public function response($data)
    {
        return \Response::json($data);
    }
}

<?php
// LessonController.php
class LessonController extends ApiController
{
    public function index()
    {
        $lessons = Lesson::all();
        return $this->response([
            'status'=>'Success',
            'status_code'=>'200',
            'data'=>$this->lessonTransfromer->transformCollection($lessons)
        ]);
    }

    public function show(Lesson $lesson)
    {
        return $this->response([
            'status'=>'Success',
            'status_code'=>'200',
            'data'=>$this->lessonTransfromer->transform($lesson->toArray())
        ]);
    }
}

<?php
// app\Exceptions\Handler.php
    use Illuminate\Database\Eloquent\ModelNotFoundException as ModelNotFoundException;
    public function render($request, Exception $exception)
    {
        if ($exception instanceof ModelNotFoundException) {
            $api = new \App\Http\Controllers\ApiController;
            return $api->responseNotFound('404 not found');
        }
        return parent::render($request, $exception);
    }

第6章对请求API的用户认证

生成用户验证模块

php artisan make:auth

<?php
// app\Http\Controllers\Auth\RegisterController.php
use App\Models\User;

编辑控制器

<?php
// app\Http\Controllers\LessonController.php
    public function __construct(LessonTransfromer $lessonTransfromer)
    {
        $this->middleware('auth.basic',['only'=>['index', 'store']]);
    }

    public function store(Request $request)
    {
        if (! $request->get('title') or ! $request->get('body') or ! $request->get('free')){
            return $this->setStatusCode(422)->response('validata fails');
        }

        Lesson::create($request->all());

        return $this->setStatusCode(201)->response([
            'status'=>'success',
            'message'=>'lesson created'
        ]);
    }

<?php
// app\Models\Lesson.php
class Lesson extends Model
{
    protected $fillable = ['title','body','free'];
}

最后使用 postman 调试 http://api.dev/api/v1/lesson/

第7章引入 Dingo API 和 JWT

7.1 引入 Dingo API

官方： https://github.com/dingo/api
中文： https://github.com/liyu001989/dingo-api-wiki-zh

<?php
// api\composer.json
"require": {
    "dingo/api": "1.0.*@dev"
}

composer update

# config\app.php
'providers' => [
    Dingo\Api\Provider\LaravelServiceProvider::class,
]

添加 Facades

# config\app.php
'aliases' => [
    'API' => Dingo\Api\Facade\API::class,
    'DingoRoute' => Dingo\Api\Facade\Route::class,
]

发布配置文件

php artisan vendor:publish --provider="Dingo\Api\Provider\LaravelServiceProvider"

7.2 引入 JWT

主页 https://github.com/tymondesigns/jwt-auth/
安装文档 https://github.com/tymondesigns/jwt-auth/wiki/Installation

<?php
// api\composer.json
"require": {
    "tymon/jwt-auth": "0.5.*"
}

composer update

# config\app.php
'providers' => [
    Tymon\JWTAuth\Providers\JWTAuthServiceProvider::class,
]

添加 Facades

# config\app.php
'aliases' => [
    'JWTAuth' => Tymon\JWTAuth\Facades\JWTAuth::class,
    'JWTFactory' => Tymon\JWTAuth\Facades\JWTFactory::class,
]

发布配置文件

php artisan vendor:publish --provider="Tymon\JWTAuth\Providers\JWTAuthServiceProvider"

生成key

php artisan jwt:generate

第8章 Dingo API 初探

8.1 Dingo API 配置

https://github.com/liyu001989/dingo-api-wiki-zh/blob/master/Configuration.md

# api.dev\.env
API_STANDARDS_TREE=vnd
API_PREFIX=api
API_VERSION=v1
API_DEBUG=true

https://github.com/liyu001989/dingo-api-wiki-zh/blob/master/Authentication.md

# config\api.php

    // 仅供参考
    'auth' => [
        'basic' => function($app) {
            return new Dingo\Api\Auth\Provider\Basic($app['auth']);
        },
        'jwt' => function ($app){
            return new Dingo\Api\Auth\Provider\JWT($app['Tymon\JWTAuth\JWTAuth']);
        },
    ],

    'auth' => [
        'basic' => 'Dingo\Api\Auth\Provider\Basic',
        'jwt' => 'Dingo\Api\Auth\Provider\JWT',
    ],

添加路由中间件

# app\Http\Kernel.php
    protected $routeMiddleware = [
        'jwt.auth' => \Tymon\JWTAuth\Middleware\GetUserFromToken::class,
        'jwt.refresh' => \Tymon\JWTAuth\Middleware\RefreshToken::class,
    ];

8.2 Dingo API 路由

这里的路由就是 Dingo API Endpoints ，端点是路由的另一种说法,详细用法见下面文档。

https://github.com/dingo/api/wiki/Creating-API-Endpoints

请注意：v1 不能乱用，它已经在你的环境配置中定义好了。 API_VERSION=v1

<?php
$api = app('Dingo\Api\Routing\Router');

$api->version('v1', function ($api) {
    $api->group(['namespace' => 'App\Api\Controllers'], function ($api) {
        $api->get('lessons', 'LessonController@index');
    });
});

查看路由,注意区别 route:lists

php artisan api:route

地址是 /api/lessons 没有 v1 前缀，访问 http://api.dev/api/lessons/ 看到已经正常。

8.2 Dingo API 响应

https://github.com/dingo/api/wiki/Responses

下面例子演示如何使用响应生成器 (Response Builder)

8.2.1 创建 BaseController

为了使用 Dingo\Api\Routing\Helpers trait 首先要创建基础控制器

<?php
// app\Api\Controllers\BaseController.php
namespace App\Api\Controllers;

use App\Http\Controllers\Controller;
use Dingo\Api\Routing\Helpers;

class BaseController extends Controller
{
    use Helpers;
}

8.2.2 响应一个数组

意思是直接以数组形式返回 $lessons 原始数据

创建 LessonController 继承上面的 BaseController

<?php
// app\Api\Controllers\LessonController.php
namespace App\Api\Controllers;

use App\Models\Lesson;

class LessonController extends BaseController
{
    public function index()
    {
        $lessons =  Lesson::all();
        return $this->response->array($lessons->toArray());
    }
}

http://api.dev/api/lessons

8.2.3 响应一个元素

通过实例化 LessonTransformer 来处理 $lesson 数据，然后再返回经过处理的数据。

首先，新建 LessonController 类

<?php
// app\Api\Controllers\LessonController.php
namespace App\Api\Controllers;

use App\Api\Transformer\LessonTransformer;
use App\Models\Lesson;

class LessonController extends BaseController
{
    /**
     * 通过实例化 LessonTransformer 来处理 $lesson 数据，然后再返回
     * LessonTransformer 类必须继承 TransformerAbstract 抽象类
     * 因为 TransformerAbstract 类提供了 item 和 collection 方法
     * 此外 LessonTransformer 类中必须有 transform 方法
     */
    public function show($id)
    {
        $lesson = Lesson::findOrFail($id);
        return $this->response->item($lesson, new LessonTransformer);
    }

}

接着，新建 LessonTransformer ，命名空间是 App\Api\Transformer

<?php
// app\Api\Transformer\LessonTransformer.php

namespace App\Api\Transformer;

use App\Models\Lesson;
use League\Fractal\TransformerAbstract;

class LessonTransformer extends TransformerAbstract
{
    public function transform(Lesson $lesson)
    {
        return [
            'title'=>$lesson['title'],
            'content'=>$lesson['body'],
            'is_free'=>(boolean) $lesson['free']
        ];
    }
}

8.2.4 响应一个元素集合

collection 会自动调用 new LessonTransformer() 中的 transform 方法

意思就是上面 LessonTransformer 类中必须有 transform 方法

<?php
// app\Api\Controllers\LessonController.php

namespace App\Api\Controllers;

use App\Api\Transformer\LessonTransformer;
use App\Models\Lesson;

class LessonController extends BaseController
{
    public function index()
    {
        $lessons  = Lesson::all();
        return $this->collection($lessons,new LessonTransformer());
    }
}

8.2.5 响应分页

<?php
// app\Api\Controllers\LessonController.php

namespace App\Api\Controllers;

use App\Api\Transformer\LessonTransformer;
use App\Lesson;

class LessonController extends BaseController
{
    public function index()
    {
        $lessons  = Lesson::paginate(10);
        return $this->paginator($lessons, new LessonTransformer);
    }
}

第9章开始使用 JWT

9.1 路由

<?php
// routes\api.php
$api = app('Dingo\Api\Routing\Router');

$api->version('v2', function ($api) {
    $api->group(['namespace' => 'App\Api\Controllers'], function ($api) {
        $api->post('user/login', 'AuthController@authenticate');
        $api->post('user/register', 'AuthController@register');
        $api->group(['middleware' => 'jwt.auth'], function ($api) {
            $api->get('lessons', 'LessonController@index');
            $api->get('lesson/{id}', 'LessonController@show');
        });
    });
});

9.2 创建 AuthController

定义 user 模型位置

<?php
// api\config\jwt.php
 'user' => 'App\Models\User',

创建 AuthController，注意这里 use 了 Request

<?php
// app\Api\Controllers\AuthController.php
namespace App\Api\Controllers;

use App\Models\User;
// 注意这里 use 了  Request
use Illuminate\Http\Request;
use JWTAuth;
use Tymon\JWTAuth\Exceptions\JWTException;

class AuthController extends BaseController
{
    public function authenticate(Request $request)
    {
        // 返回请求中 email 和 password 的值
        $credentials = $request->only('email', 'password');

        try {
            // attempt to verify the credentials and create a token for the user
            if (! $token = JWTAuth::attempt($credentials)) {
                return response()->json(['error' => 'invalid_credentials'], 401);
            }
        } catch (JWTException $e) {
            // something went wrong whilst attempting to encode the token
            return response()->json(['error' => 'could_not_create_token'], 500);
        }

        // 登录成功后，以 json 形式返回 token 值
        return response()->json(compact('token'));
    }

    public function register(Request $request)
    {
        $newUser = [
            'email' => $request->get('email'),
            'name' =>  $request->get('name'),
            'password' =>  $request->get('password'),
        ];

        $user = User::create($newUser);
        $token = JWTAuth::fromUser($user);
        // 注册成功后返回 token
        return response()->json(compact('token'));
    }
}

9.3 调试

登录调试：post 请求，body 携带 emial 和 password 参数

http://api.dev/api/user/login

注册调试：post 请求，body 携带 emial、name 和 password 参数

http://api.dev/api/user/register

先登录获取 token ，然后显示内容

http://api.dev/api/lesson/1?token=xxx http://api.dev/api/lessons?token=xxx

第10章 JWT 其他用法

10.1 根据 token 返回用户信息

路由

<?php
// routes\api.php
   $api->group(['middleware' => 'jwt.refresh'], function ($api) {
       $api->get('user/info', 'AuthController@getAuthenticatedUser');
   });

AuthController

<?php
//app\Api\Controllers\AuthController.php

use Tymon\JWTAuth\Exceptions\JWTException;
use Tymon\JWTAuth\Exceptions\TokenExpiredException;
use Tymon\JWTAuth\Exceptions\TokenInvalidException;

    public function getAuthenticatedUser()
    {
        try {
            if (! $user = JWTAuth::parseToken()->authenticate()) {
                return response()->json(['user_not_found'], 404);
            }
        } catch (TokenExpiredException $e) {
            return response()->json(['token_expired'], $e->getStatusCode());
        } catch (TokenInvalidException $e) {
            return response()->json(['token_invalid'], $e->getStatusCode());
        } catch (JWTException $e) {
            return response()->json(['token_absent'], $e->getStatusCode());
        }

        return response()->json(compact('user'));
    }

调试：http://api.dev/api/user/info?token=xx

10.2 解决请求字段与数据库不一致问题

注意 password 没有变

<?php
//app\Api\Controllers\AuthController.php
        $credentials = [
            'user_email' => $request->get('user_email'),
            'password' => $request->get('user_password'),
        ];

增加 getAuthPassword 方法

<?php
// api\app\Models\User.php
    public function getAuthPassword()
    {
        return $this->user_password;
    }

资源：

https://coding.net/u/wangyan/p/laravel-api/git https://www.codecasts.com/series/dive-into-restful-api-with-laravel

CentOS 从源码安装配置 PHP7.1

Mon, 15 May 2017 00:00:00 +0800

一、安装依赖

libmcrypt-devel 需要使用 epel 源

rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

安装必须的依赖

yum install -y \
    gcc gcc-c++ \
    freetype-devel libxml2-devel libcurl-devel libjpeg-turbo-devel libpng-devel openssl-devel libicu-devel libxslt-devel \
    libmcrypt-devel

二、安装 imap

centOS7 已经没有了 libc-client，需要编译安装

注：epel 源可以找到 libc-client-devel uw-imap-devel uw-imap-static uw-imap-utils，但直接安装还是会出现一些问题。

编译安装

http://files.wangyan.org/src/lemp/imap-2007f.tar.gz

wget ftp://ftp.cac.washington.edu/imap/imap-2007f.tar.gz
tar -zxf imap-2007f.tar.gz
cd imap-2007f
make lr5 PASSWDTYPE=std SSLTYPE=unix.nopwd EXTRACFLAGS=-fPIC IP=4
mkdir -p /usr/local/imap-2007f/{include,lib,c-client}
cp c-client/*.h /usr/local/imap-2007f/include/ 
cp c-client/*.c /usr/local/imap-2007f/lib/ 
cp c-client/*.c /usr/local/imap-2007f/c-client/ 
cp c-client/c-client.a /usr/local/imap-2007f/lib/libc-client.a 
cp c-client/c-client.a /usr/local/imap-2007f/c-client/libc-client.a

备注：在 64 位下编译时 make 参数需要带 EXTRACFLAGS=-fPIC ，在 32 位下则不需要。

三、安装 PHP

tar zxf php-7.1.6.tar.gz
cd php-7.1.6
./configure \
    --prefix=/usr/local/php \
    --with-config-file-path=/usr/local/php/etc  \
    --with-config-file-scan-dir=/usr/local/php/conf.d  \
    --with-curl  \
    --with-fpm-user=www  \
    --with-fpm-group=www  \
    --with-freetype-dir  \
    --with-gd  \
    --with-gettext  \
    --with-iconv-dir \
    --with-imap=/usr/local/imap-2007f \
    --with-imap-ssl \
    --with-jpeg-dir \
    --with-libxml-dir \
    --with-mcrypt \
    --with-mhash \
    --with-mysqli=mysqlnd \
    --with-openssl \
    --with-pdo-mysql=mysqlnd \
    --with-png-dir \
    --with-xmlrpc \
    --with-xsl \
    --with-zlib \
    --enable-calendar \
    --enable-bcmath \
    --enable-exif \
    --enable-fpm  \
    --enable-ftp \
    --enable-gd-native-ttf \
    --enable-intl \
    --enable-mbstring \
    --enable-mysqlnd \
    --enable-shmop \
    --enable-sockets \
    --enable-sysvsem \
    --enable-zip

    make -j4
    make install

三、php 配置

ln -s /usr/local/php/bin/php /usr/bin/php

mkdir -p /usr/local/php/conf.d /tmp/php
cp php-7.1.6/php.ini-production /usr/local/php/etc/php.ini
cp php-fpm.conf /usr/local/php/etc/php-fpm.conf

php.ini 设置

sed -i "s|;*date.timezone =.*|date.timezone = PRC|i" /usr/local/php/etc/php.ini && \
sed -i "s|;*memory_limit =.*|memory_limit = 512M|i" /usr/local/php/etc/php.ini && \
sed -i "s|;*upload_max_filesize =.*|upload_max_filesize = 128M|i" /usr/local/php/etc/php.ini && \
sed -i "s|;*max_file_uploads =.*|max_file_uploads = 25|i" /usr/local/php/etc/php.ini && \
sed -i "s|;*post_max_size =.*|post_max_size = 256M|i" /usr/local/php/etc/php.ini && \
sed -i "s|;\s*max_input_vars =.*|max_input_vars = 5000|i" /usr/local/php/etc/php.ini && \
sed -i "s|;*cgi.fix_pathinfo=.*|cgi.fix_pathinfo= 0|i" /usr/local/php/etc/php.ini && \
sed -i 's|;upload_tmp_dir =.*|upload_tmp_dir = \/tmp\/php|i' /usr/local/php/etc/php.ini && \
sed -i 's|max_execution_time =.*|max_execution_time = 300|i' /usr/local/php/etc/php.ini && \
sed -i 's|disable_functions =.*|disable_functions = passthru,exec,system,chroot,scandir,chgrp,chown,shell_exec,popen,ini_alter,ini_restore,dl,openlog,syslog,readlink,symlink,popepassthru,stream_socket_server|g' /usr/local/php/etc/php.ini

开机自启动

cp php-7.1.6/sapi/fpm/init.d.php-fpm /etc/init.d/php-fpm
chmod +x /etc/init.d/php-fpm
chkconfig --add php-fpm
service php-fpm restart

CentOS 从 Yum 源安装配置 PHP7.1

Mon, 01 May 2017 00:00:00 +0800

安装第三方YUM源

rpm -Uvh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
rpm -Uvh https://mirror.webtatic.com/yum/el7/webtatic-release.rpm

安装 php7.1.x

yum install \
    php71w-bcmath \
    php71w-common \
    php71w-fpm \
    php71w-gd \
    php71w-imap \
    php71w-mbstring \
    php71w-mcrypt \
    php71w-mysql \
    php71w-opcache \
    php71w-pdo \
    php71w-pdo_dblib \
    php71w-pear \
    php71w-pecl-mongodb \
    php71w-xml \
    php71w-xmlrpc

安装 php5.6.x

yum install \
    php56w-bcmath \
    php56w-common \
    php56w-fpm \
    php56w-gd \
    php56w-imap \
    php56w-mbstring \
    php56w-mcrypt \
    php56w-mysql \
    php56w-opcache \
    php56w-pear \
    php56w-pecl-xdebug \
    php56w-pgsql \
    php56w-xml \
    php56w-xmlrpc

启动 php

sudo systemctl start php-fpm && \
sudo systemctl enable php-fpm

    sed -i "s|;*date.timezone =.*|date.timezone = Asia/Shanghai|i" /etc/php.ini && \
    sed -i "s|;*memory_limit =.*|memory_limit = 512M|i" /etc/php.ini && \
    sed -i "s|;*upload_max_filesize =.*|upload_max_filesize = 128M|i" /etc/php.ini && \
    sed -i "s|;*max_file_uploads =.*|max_file_uploads = 25|i" /etc/php.ini && \
    sed -i "s|;*post_max_size =.*|post_max_size = 256M|i" /etc/php.ini && \
    sed -i "s|;\s*max_input_vars =.*|max_input_vars = 5000|i" /etc/php.ini && \
    sed -i "s|;*cgi.fix_pathinfo=.*|cgi.fix_pathinfo= 0|i" /etc/php.ini && \

参考文档：

https://webtatic.com/packages/php71/

PHP 匿名函数和闭包

Sun, 01 Jan 2017 00:00:00 +0800

一、闭包的基本用法

1.1 示例1：作为变量的值来使用

闭包可以作为变量的值来使用，因为闭包实际是 PHP 内置类 Closure 的对象实例，数据类型是对象，因此我们可以把一个 closure 对象赋值给一个变量。

// 闭包赋值给 $clousre 变量
$clousre = function ($name) {
    return 'Hello ' . $name;
};

// 可以用"变量名+括号"的形式调用，是因为 Closure 类中有 __invoke() 魔术方法
// 当尝试以调用函数的方式调用一个对象时，__invoke() 方法会被自动调用。
// nesfo 会传递给 $name 变量
echo $closure('nesfo');

参考链接：

1.2 示例2：作为回调函数参数的值

闭包经常作为回调函数（callback）参数的值来使用

// 根据第一个参数给出的规则，使用一个回调函数替换第三个参数给出的内容。
// 注意回调函数的参数($match)是一个数组，其最后返回真正参与替换的字符串
// $match[1] 的值是 -w
echo preg_replace_callback('~-([a-z])~', function ($match) {
    // 将 -w 转换成大写 W
    return strtoupper($match[1]);
}, 'hello-world');
// 输出 helloWorld

参考链接：

preg_replace_callback 函数

1.3 示例3：从父作用域继承变量

闭包可以从父作用域中继承变量，但是需要使用 use 来传递进去。

$message = 'hello';

// 没有 "use"
$example = function () {
    var_dump($message);
};
echo $example();
//输出为null，匿名函数无法继承外部变量 $message，因为没有 "use"

使用 use 传递父作用域 $message 变量

// 继承 $message
$message = 'hello';

$example = function () use ($message) {
    var_dump($message);
};
echo $example();
//输出 string 'hello' (length=5)，使用关键词 use 后，
//匿名函数可以获取到外部变量 $message.

引用继承，原理是匿名函数在定义时（不是在调用时）会获取其所继承的变量的值

$message = 'hello';
// 引用继承，注意 &message
$example = function () use (&message) {
    var_dump($message);
};
$message = 'world';
echo $example();
//输出 string 'world' (length=5),

二、Closure 闭包类

前面说过，闭包是 Closure 类的一个实例

Closure 类定义了三种方法：

Closure::__construct — 构造函数，定义了 Closure 类禁止实例化。
Closure::bindTo — 复制当前闭包对象内容，并给这个闭包绑定一个新的对象和类作用域
Closure::bind — 复制一个闭包对象内容，并给这个闭包绑定一个新的对象和类作用域

2.1 Closure::bindTo

复制当前闭包对象（创建并返回一个新的闭包），并给这个闭包绑定一个新的对象($newthis)，并且可以为这个闭包指定类作用域($newscope)。

// newthis 绑定给匿名函数的一个对象，或者 NULL 来取消绑定。
// newscope 为这个新闭包指定类作用域，或者 'static' 保持当前状态。
// 返回新创建的 Closure 对象 或者在失败时返回 FALSE
public Closure Closure::bindTo ( object $newthis [, mixed $newscope = 'static' ] )

如果你只是想要复制一个闭包，不需要绑定新到对象，可以用 cloning 代替。

bindTo 示例：

class A {
    function __construct($val) {
        $this->val = $val;
    }
    function getClosure() {
        //returns closure bound to this object and scope
        return function() { return $this->val; };
    }
}

$ob1 = new A(1);
$ob2 = new A(2);

// 返回一个闭包对象，注意这里的 $this 指向的是 $ob1 对象
$cl = $ob1->getClosure();
echo $cl(), "\n"; //结果是 1

// 复制上面 $cl 这个闭包对象内容，将 $this 绑定到了 $ob2 对象
$cl = $cl->bindTo($ob2);
echo $cl(), "\n"; //结果是 2

参考链接：

Closure::bindTo

2.2 Closure::bind

这个方法是 Closure::bindTo() 的静态版本。

语法结构：

public static Closure Closure::bind ( Closure $closure , object $newthis [, mixed $newscope = 'static' ] )

closure 需要绑定的匿名函数
newthis 需要绑定到匿名函数的对象，或者 NULL 创建未绑定的闭包
newscope 想要绑定给闭包的类作用域，或者 ‘static’ 表示不改变

bind 示例：

class A {
    private static $sfoo = 1;
    private $ifoo = 2;
}
// 注意 $cl1 是 static 静态版闭包
$cl1 = static function() {
    return A::$sfoo;
};
// $ifoo 是非静态属性，使用  $this->ifoo 访问
$cl2 = function() {
    return $this->ifoo;
};

// 复制 $cl1 闭包，不绑定新对象，作用域 class A
$bcl1 = Closure::bind($cl1, null, 'A');

// 复制 $cl2 闭包，绑定到 new A() 对象，作用域 class A
// 这里必须要为 $this 绑定到一个对象，而上面的 $cl1 是静态的，可以直接 A::$sfoo 访问，不需要绑定对象。
$bcl2 = Closure::bind($cl2, new A(), 'A');

echo $bcl1(), "\n"; // 1
echo $bcl2(), "\n"; // 2

参考链接：

Closure::bind

三、闭包的作用

3.1 读取局部变量

通过闭包可以读取其他函数的内部变量

function f1() {
    $n = 2;
    // 通过闭包函数 $f2 使用 use 关键字获取外部变量 $n
    $f2 = function () use($n) {
        return $n;
    };
    return  $f2;
}
var_dump($n);
// null, 因为 $n 是函数内的局部变量

$f = f1();
var_dump($f());
//int 2

3.2 使用 bindTo() 或者 Closure::bind

bindTo 或者 Closure::bind 方法可以把闭包的 $this 绑定到其他对象上，这样闭包就可以访问那个对象中受保护和私有的成员变量。

class App
{
    protected $routes = [];
    protected $responseStatus = '200 OK';
    protected $responseContentType = 'text/html';
    protected $responseBody = 'Hello world';

    public function addRoute($routePath, $routeCallback){
        $this->routes[$routePath] = Closure::bind($routeCallback,$this, __CLASS__);
        //$this->routes[$routePath] = $routeCallback->bindTo($this, __CLASS__);
    }
    
    public function dispatch($currentPath){
        foreach($this->routes as $routePath => $callback){
            if ($routePath === $currentPath) {
                // 闭包中的 __invoke() 方法会被自动调用
                // $callback(5); 闭包可以加参数
                $callback();
            }
        }

        // $this->responseBody 原来值是 Hello world
        // 闭包绑定到 App 后，默认值修改为 {"name": "nesfo"}
        header('HTTP/1.1' . $this->responseStatus);
        header('Content-type: ' . $this->responseContentType);
        header('Content-length' . mb_strlen($this->responseBody));
        echo $this->responseBody;
    }
}

$app = new App();
$app->addRoute('/user/nesfo', function ($test) {
    $this->responseContentType = 'application/json; charset=utf8';
    $this->responseBody = '{"name": "nesfo"}';
    $this->test = $test;
});
$app->dispatch('/user/nesfo');

参考文档：

学习PHP闭包
《Modern PHP》

Laravel 5.3 中文文档：快速入门——安装

Wed, 21 Sep 2016 00:00:00 +0800

安装

安装

安装

运行环境要求

Laravel 框架会有一些系统上的要求。当然，这些要求在 Laravel Homestead 虚拟机上都已经完全配置好了，强烈建议使用 Homestead 作为本地开发环境。

不过，如果你没有使用 Homestead，那么需要保证运行环境满足以下要求：

- PHP >= 5.6.4 - OpenSSL PHP Extension - PDO PHP Extension - Mbstring PHP Extension - Tokenizer PHP Extension

译者注：强烈推荐使用 Homestead 作为开发环境，尤其是新手，可以避免很多不必要的麻烦。线上环境可以参考 Homestead 的环境部署脚本进行部署。

安装 Laravel

Laravel 使用 Composer 来管理代码依赖。所以，在使用 Laravel 之前，请先确认你的电脑上安装了 Composer。

通过 Laravel 安装工具

首先，通过 Composer 安装 Laravel 安装工具：

composer global require "laravel/installer"

请确保 ~/.composer/vendor/bin 目录 (或者你操作系统类似的目录) 在你的系统环境变量中，这样 laravel 才可以在你系统任意路径调用运行。

译者注：例如 windwos 系统，该目录是 C:/Users/xxxx/AppData/Roaming/Composer

一旦安装完成，就可以使用 laravel new 命令在指定目录创建一个新的 Laravel 项目，例如：laravel new blog 将会在当前目录下创建一个叫 blog 的新应用，此目录里面存放着新安装的 Laravel 和代码依赖。

laravel new blog

译者注：通过这种方式安装，速度要比通过 Composer 安装要快上许多，因为代码依赖是直接一起打包安装的。

通过 Composer Create-Project

除此之外，你也可以通过 Composer 在命令行运行 create-project 命令来安装 Laravel：

composer create-project --prefer-dist laravel/laravel blog

译者注：如果要下载其他版本，比如 5.1 LTS 版本，可以使用这个命令：

composer create-project --prefer-dist laravel/laravel blog 5.1.*

本地开发服务器

如果你在本地安装了 PHP ，想使用 PHP 内置的 Web 服务器访问应用。你需要使用 serve Artisan 命令。这个命令会启动 PHP 内置的开发服务器，通过 http://localhost:8000 访问。

php artisan serve

当然，了解更多本地开发选项，请阅读文档 Homestead 和 Valet。

配置信息

Public 目录

安装完成后，你应该指定 Web 服务器的网站根目录到 public 文件夹上。在这个文件夹下的 index.php 文件是所有 HTTP 请求的入口控制文件。

配置文件

所有 Laravel 框架的配置文件都放置在 config 目录下。每个选项都有说明，请仔细阅读这些说明，并熟悉这些选项配置。

目录权限

安装 Laravel 之后，你必须设置一些文件目录权限。storage 和 bootstrap/cache 目录必须让 Web 服务有写入权限。否则 laravel 将无法运行。如果你使用 Homestead 虚拟机，那么这些权限已经被设置好了。

应用程序密钥

安装完 Laravel 后，下一步要做的事情是将应用程序密钥设置为一个随机字符串。假设你是通过 Composer 或是 Laravel 安装工具安装的 Laravel，那么这个密钥已经通过 key:generate 命令帮你设置完成。

这个密钥可以被设置在 .env 环境文件中。如果你还没将 .env.example 文件重命名为 .env，那么你现在应该去设置下。

如果应用程序密钥没有被设置的话，你的用户 Session 和其它的加密数据都是不安全的！

其它设置

Laravel 几乎不需做任何其它设置就可以马上使用，但是建议你先浏览 config/app.php 文件和对应的文档，这里面包含着一些选项，如 时区 和 语言环境，你可以根据应用程序的情况来修改。

你也可以设置 Laravel 的几个附加组件，像是：

- [缓存](/laravel-5.3-cache#configuration) - [数据库](/laravel-5.3-database#configuration) - [Session](/laravel-5.3-session#configuration)

一旦 Laravel 安装完成，你应该立即设置本机环境。

最后更新：2016.09.21

Laravel 5.3 中文文档：序言——贡献指南

Tue, 20 Sep 2016 00:00:00 +0800

贡献指南 (Contribution Guide)

Bug 反馈 (Bug Reports)

为了提倡积极协作，Laravel 强烈鼓励使用 GitHub 的 pull requests，而不是仅仅报告 Bug，「Bug 反馈」可以以一个包含失败测试的 Pull Request 的形式发送。

假如你提交了「Bug 反馈」，那么反馈中应该包含着标题和详尽的问题描述，并尽可能多的提供相关的信息和该 Bug 的代码示例。这样做的主要目的是让自己和其他人可以简单地重现并修复该 Bug。

请记住，「Bug 反馈」的初衷是让其它有相同问题的人可以协作解决问题。不要期望反馈 Bug 后，马上就会有人修复了它。创建「Bug 反馈」主要是为了能帮助你自己和其他人开始着手修复问题。

Laravel 源代码托管在 GitHub 上面，并且每一个 Laravel 项目都有其对应的代码仓库：

核心开发讨论 (Core Development Discussion)

你可以在 Laravel 讨论组 issue board 提出新特性或者改进。如果你提出了新的特性，请至少附上完成新特性需要的相关代码。

有关错误、新功能和现有功能的实现讨论会在 Slack 的 LaraChat 群组上的 #internals 频道中进行。Laravel 的维护者 Taylor Otwell 在工作日的上午8点到下午5点（西六区或美国芝加哥时间）通常会出现在频道上，其它时间也可能偶尔在线。

选择分支 (Which Branch?)

所有的 Bug 修复应该提交到 latest stable 稳定分支上。Bug 修复 永远不要 提交到 master 分支，除非它修复的功能只存在下一版的发布中。

次要的 且与现有的 Laravel 发布版本 完全向下兼容 的功能可以发送到最新的稳定分支。

主要的 新功能应该都发送到 master 分支，它包含下一版的 Laravel 发布内容。

如果不确定你的功能是主要的还是次要的，请在 Slack 的 LaraChat 群组上的 #internals 频道询问 Taylor Otwell。

安全漏洞 (Security Vulnerabilities)

如果你发现 Laravel 存在安全漏洞，请发送电子邮件到 taylor@laravel.com 给 Taylor Otwell。所有的安全漏洞将会被及时解决。

编码风格 (Coding Style)

Laravel 遵守 PSR-2 编码规范和 PSR-4 自动加载规范。

译者注：扩展阅读 - 所有 PSR 的标准规范。

PHPDoc

下面是一个示范文档单元。请注意 @param 属性后有是有两个空格，参数类型两个以上空格，最后是变量类型名称。

/**
 * 为服务容器注册一个绑定
 *
 * @param  string|array  $abstract
 * @param  \Closure|string|null  $concrete
 * @param  bool  $shared
 * @return void
 */
public function bind($abstract, $concrete = null, $shared = false)
{
    //
}

StyleCI

如果你的编码风格不完美，别着急！当你 pull requests 到 Laravel 版本库后， StyleCI 可以自动合并修复任何风格。这使我们能够专注于内容的贡献，而不是编码风格。

最后更新：2016.09.21

Laravel 5.3 中文文档：序言——版本说明

Mon, 19 Sep 2016 00:00:00 +0800

版本说明 (Release Notes)

支持政策 (Support Policy)

对于 LTS 版本，比如 Laravel 5.1，会提供为期两年的 bug 修复和三年的安全修复支持。LTS 版本是 Laravel 能提供的维护时间最长的发行版。

对于其他通用版本，只提供六个月的 bug 修复和一年的安全修复支持。

Laravel 的发布路线图 - by Summer

Laravel 5.3

Laravel 5.3 在 5.2 基础上进行了优化，新特性包括以下：

消息通知 Laravel Notifications；
事件广播 Laravel Echo；
OAuth2 授权认证 Laravel Passport；
全文搜索引擎 Laravel Scout；
Laravel Elixir 开始支持 Webpack；
Mail 操作类 Laravel Mailable；
web 和 api 的路由分离；
基于闭包的控制台命令；
更加易用的辅助函数，用于存储上传的文件；
支持 POPO 和单动作控制；
优化默认的前端脚手架，等等。

消息通知 (Notifications)

{video} Laracasts 上关于此新特性的免费视频 video tutorial。

Laravel Notifications 提供了简单、优雅的 API 支持你通过不同的渠道发送通知，例如电子邮件、Slack、手机短信等等。

例如，你可以定义一个单据 (invoice)，当该单据被付款后，则通过邮件和手机短信发送提醒通知：

你可用通过下面这个简单的方法来实现：

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

Laravel 社区已经为通知系统编写了各式的驱动，甚至包括对 iOS 和 Android 通知的支持，更多关于通知系统的信息，请查看完整的文档。

WebSockets / 事件广播 (Event Broadcasting)

事件广播在之前版本的 Laravel 中已经存在，Laravel 5.3 现支持对私有和已存在的 WebSocket 频道添加频道级认证：

/*
 * Authenticate the channel subscription...
 */
Broadcast::channel('orders.*', function ($user, $orderId) {
    return $user->placedOrder($orderId);
});

Laravel Echo 是一个可通过 NPM 安装的全新的 JavaScript 包，会随 Laravel 5.3 一起发布。Echo 提供了简单、优雅的 API 接口，支持你在 JavaScript 客户端应用中，订阅频道和监听服务器端事件。

Echo 提供的支持包括 Pusher 以及 Socket.io：

Echo.channel('orders.' + orderId)
    .listen('ShippingStatusUpdated', (e) => {
        console.log(e.description);
    });

除了订阅到传统频道上，Laravel Echo 也让频道的监听与管理变得更加简单：

Echo.join('chat.' + roomId)
    .here((users) => {
        //
    })
    .joining((user) => {
        console.log(user.name);
    })
    .leaving((user) => {
        console.log(user.name);
    });

了解更多关于 Echo 和事件广播(event broadcasting)的信息，请查阅完整文档.

Laravel Passport (OAuth2 认证服务)

{video} Laracasts 上关于此功能的免费视频 video tutorial。

Laravel 5.3 的 Passport 让 API 认证变得简单。Laravel Passport 可以让你在几分钟内为应用程序创建一个完整的 OAuth2 认证服务，Passport 基于 Alex Bilbie 的 League OAuth2 server 实现。

Passport 让发放 OAuth2 令牌（Access Token）变得轻松，你还可以允许用户通过 Web 界面创建 个人访问令牌 (personal access tokens)。

为了方便提高开发效率，Passport 内置了一个 Vue 组件，该组件提供了 OAuth2 后台界面功能，允许用户创建客户端、撤销访问令牌，以及更多其他功能：

<passport-clients></passport-clients>
<passport-authorized-clients></passport-authorized-clients>
<passport-personal-access-tokens></passport-personal-access-tokens>

如果你不想使用 Vue 组件，你可以自由的定制用于管理客户端和访问令牌(access tokens)的前端及后台。Passport 提供了一个简单的 JSON API，你可以在前端使用任何 JavaScript 框架与之集成。

当然，Passport 还提供了方便的 API 让你定制「Token 访问域 (access token scopes)」：

Passport::tokensCan([
    'place-orders' => 'Place new orders',
    'check-status' => 'Check order status',
]);

此外，Passport 还包含了一个用于检查「Token 访问域 (access token scopes)」访问权限的中间件：

Route::get('/orders/{order}/status', function (Order $order) {
    // Access token has "check-status" scope...
})->middleware('scope:check-status');

最后，Passport 还支持从 JavaScript 应用访问你的 API，而不必担心访问令牌传输。

Passport 通过加密 JWT cookies 和同步「CSRF 令牌」来实现此功能，让你专注于业务开发。

更多关于 Passport 信息，请查看完整文档。

搜索系统 (Laravel Scout)

Laravel Scout 提供了一个简单的、基于驱动的、针对 Eloquent 模型的全文搜索解决方案。

通过模型观察者(model observers)，Scout 会自动同步更新 Eloquent 的搜索索引，目前，Scout使用 Algolia 驱动，你可以自由的编写自己驱动来扩展 Scout。

你只需要添加 Searchable trait 到模型中，就能让模型支持搜索：

<?php

namespace App;

use Laravel\Scout\Searchable;
use Illuminate\Database\Eloquent\Model;

class Post extends Model
{
    use Searchable;
}

在你在模型中添加 trait 以后，数据会在 save 的时候自动保持同步：

$order = new Order;

// ...

$order->save();

在模型被成功索引以后，可以很轻松的使用全文搜索，你甚至可以为索引的结果进行分页操作：

return Order::search('Star Trek')->get();

return Order::search('Star Trek')->where('user_id', 1)->paginate();

更多 Scout 功能，请查阅 Scout 的完整文档。

Mailable 对象 (Mailable Objects)

{video} Laracasts 上关于此功能的免费视频 video tutorial。

Laravel 5.3 Mailable 是一个崭新的 Mail 操作类，通过一种更加优雅的方式发送邮件，而不再需要在闭包中自定义邮件信息。

例如，定义一个简单的邮寄对象用作发送欢迎邮件：

class WelcomeMessage extends Mailable
{
    use Queueable, SerializesModels;

    /**
     * Build the message.
     *
     * @return $this
     */
    public function build()
    {
        return $this->view('emails.welcome');
    }
}

Mailable 对象被创建以后，你可以使用一个简单、优雅的 API 将其发送给用户：

Mail::to($user)->send(new WelcomeMessage);

Mailable 还支持队列操作，只需要在类声明里实现 ShouldQueue 即可：

class WelcomeMessage extends Mailable implements ShouldQueue
{
    //
}

更多关于 Mailable 的信息，请查看完整文档。

存储上传文件 (Storing Uploaded Files)

{video} Laracasts 上关于此功能的免费视频 video tutorial。

存储用户上传文件，在 Web 开发中是一个很常见的任务。Laravel 5.3 提供了一个便捷的 store 方法，只需要对上传文件对象调用此方法，并传参准备存储的路径即可：

/**
 * Update the avatar for the user.
 *
 * @param  Request  $request
 * @return Response
 */
public function update(Request $request)
{
    $path = $request->file('avatar')->store('avatars', 's3');

    return $path;
}

更多上传文件信息，请查看完整文档。

Webpack & Laravel Elixir

Laravel Elixir 6.0 与 Laravel 5.3 共同发布，内置了 Webpack 和 Rollup JavaScript。

默认情况下，Laravel 5.3 的 gulpfile.js 使用 Webpack 来编译你的 JavaScript 文件：

elixir(mix => {
    mix.sass('app.scss')
       .webpack('app.js');
});

完整文档请见 Laravel Elixir 。

前端架构 (Frontend Structure)

{video} Laracasts 上关于此功能的免费视频 video tutorial。

Laravel 5.3 提供了一个更加现代的前端架构。这主要会影响 make:auth 命令生成认证相关的前端脚手架(scaffolding)代码，不再从 CDN 中加载前端资源，所有依赖被定义在默认的 package.json 文件中，你可以自行修改。

此外，支持单文件的 Vue 组件现在直接开箱即用， resources/assets/js/components 目录下包含了一个简单的示例 Example.vue，新的 resources/assets/js/app.js 用来配置 JavaScript 类库依赖和 Vue 子模块。

这种架构对开始开发现代的、强大的 JavaScript 应用提供了更好的支持，而不需要要求应用使用任何特定 JavaScript 或者 CSS 框架。

更多信息，请查看对应文档前端文档。

路由文件 (Routes Files)

默认情况下，新安装的 Laravel 5.3 应用在新的顶级目录 routes 下包含了 web.php 和 api.php 两个 HTTP 路由文件，你也可以按照此方法自行扩展。

API 相关的路由在 RouteServiceProvider 中指定了自动添加 api 前缀。

闭包控制台命令 (Closure Console Commands)

除了通过命令类定义之外，Artisan 命令现支持在 app/Console/Kernel.php 文件中使用简单闭包的方式定义。

在新安装的 Laravel 5.3 应用中，commands 方法会加载 routes/console.php 文件，从而允许你基于闭包、以路由风格定义控制台命令：

Artisan::command('build {project}', function ($project) {
    $this->info('Building project...');
});

更多信息请参见 Artisan 文档。

Blade 中的 `$loop` 变量 (The `$loop` Variable)

{video} Laracasts 上关于此功能的免费视频 video tutorial。

当我们在 Blade 模板中循环遍历的时候，$loop 魔术变量将会在循环中生效。通过该变量可以访问很多有用的信息，比如当前循环索引值，以及当前循环是第一个还是最后一个：

@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 {{ $user->id }}</p>
@endforeach

更多信息请查看 Blade 文档.

Laravel 5.2

Laravel 5.2 在 Laravel 5.1 的基础上进行了优化，新特性包括以下：

支持更多样的用户认证驱动；
隐式数据模型绑定；
简化 Eloquent 全局作用域；
内置用户认证脚手架支持；
中间件组；
访问频率限制中间件；
数组认证的优化等

用户认证驱动 / “多认证系统 (Multi-Auth)”

在之前的 Laravel 版本中，框架只支持默认的、基于 session 的认证驱动，且在单个应用中只能拥有一个认证模型类。

Laravel 5.2 对此进行了改进，你可以定义多个认证驱动，还支持多个可认证的数据模型以及用户表，并且可以独立控制其认证。

例如，如果你的应用中有一张「admin」数据库用户表，一张「student」数据库用户表（一个后台管理员用户表和一个前台学生用户表），现在你可以使用 Auth 方法来实现后台用户和学生用户的独立登录而不相互影响。

用户认证脚手架 (Authentication Scaffolding)

此前 Laravel 后端认证处理已经是相当容易了，现在 Laravel 5.2 提供了一个更加便捷、快速的方法来创建前台认证视图，只需要简单的在终端执行 make:auth 命令即可。

php artisan make:auth

该命令会生成纯文本的、兼容 Bootstrap 样式的视图用于登录、注册和密码重置。该命令还会顺带在路由文件中增加对应的授权路由。

{note} 该功能特性只能用于新创建的应用，不能用于升级后的应用。

隐式模型绑定 (Implicit Model Binding)

隐式模型绑定使得在路由和控制器中注入模型实例更加便捷。例如，假设你定义了一个如下的路由：

use App\User;

Route::get('/user/{user}', function (User $user) {
    return $user;
});

在 Laravel 5.1 中，你通常需要通过 Route::model 方法告诉 Laravel 注入 App\User 实例以匹配路由定义中的 {user} 参数。

现在，在 Laravel 5.2 中，框架将会基于相应 URI 判断自动注入模型，从而允许你快速访问需要的模型实例。

如路由参数片段 {user} 匹配到 路由闭包 或 控制器方法 中对应参数 $user，且类型提示为 Eloquent 数据模型的话，Laravel 将会自动注入该模型。

更多隐式模型绑定信息，请查看 HTTP 路由模型绑定部分。

中间件群组 (Middleware Groups)

中间件群组允许你将多个路由中间件组织到单一、方便的键（即群组名称）下面，从而可以为某个路由一次指派多个中间件。例如，在同一个应用中构建 Web UI 或 API 时，这一特性很有用。例如，你可以將 session 及 CSRF 路由組合成一個 web 群組，并将访问频率限制分组到 api群组。

实际上，默认的 Laravel 5.2 应用结构采用的正是这种方法。例如，在默认的 App\Http\Kernel.php 文件中你会看到如下内容：

/**
 * The application's route middleware groups.
 *
 * @var array
 */
protected $middlewareGroups = [
    'web' => [
        \App\Http\Middleware\EncryptCookies::class,
        \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
        \Illuminate\Session\Middleware\StartSession::class,
        \Illuminate\View\Middleware\ShareErrorsFromSession::class,
        \App\Http\Middleware\VerifyCsrfToken::class,
    ],

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

然后，web 组可以这样指定给路由：

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

默认的，所有的 app/Http/routes.php 中的路由已经在 RouteServiceProvider 的 mapWebRoutes 方法中指定了 web 中间件组，所以你不必重复指定。

访问频率限制 (Rate Limiting)

框架现在内置了一个新的访问频率限制中间件，允许你轻松控制给定 IP 地址在指定时间内对某个路由发起请求的数目。

例如，要限制某个 IP 地址每分钟只能访问某个路由 60 次，你可以这么做：

Route::get('/api/users', ['middleware' => 'throttle:60,1', function () {
    //
}]);

数组输入验证 (Array Validation)

在 Laravel 5.2 中，可轻松验证表单中的每一个数组输入字段。例如，要验证指定数组输入字段中每一个 email 是否唯一，可以这么实现：

$validator = Validator::make($request->all(), [
    'person.*.email' => 'email|unique:users'
]);

同样的，你可以使用「 *」符号来指定要验证数组字段，自定义验证数组字段的错误消息提醒：

'custom' => [
    'person.*.email' => [
        'unique' => 'Each person must have a unique e-mail address',
    ]
],

Bail 认证规则 (Bail Validation Rule)

Laravel 5.2 新添加了一个 bail 认证规则，此规则会在第一个失败认证后停止后面的其他认证检查。例如：你想在 integer 数值检查失败后停止对 unique 唯一性的检查：

$this->validate($request, [
    'user_id' => 'bail|integer|unique:users'
]);

Eloquent 全局作用域优化 (Eloquent Global Scope Improvements)

在之前的 Laravel 版本，Eloquent 全局作用域的实现是复杂且容易出错的，但在 Laravel 5.2 中，全局查询作用域只需实现一个简单的方法 apply 即可。

更多关于全局作用域(global scopes)的信息请查阅完整的 Eloquent 文件

Laravel 5.1

Laravel 5.1 由 Laravel 5.0 改进而成，变更包括但是不限于：

采用 PSR-2 规范
支持添加事件广播
中间件参数
Artisan 的改进等等。

PHP 5.5.9+

由于 PHP 5.4 将在九月「结束寿命」，PHP 开发团队不再提供安全性更新，所以 Laravel 要求 PHP 5.5.9 或更高的版本。

PHP 5.5.9 同时也是最新版本的 PHP 函数库，像是 Guzzle 及 AWS SDK 需要的最小版本需要。

LTS

Laravel 5.1 是 Laravel 生态系统中第一个 长期支持 版本。Laravel 5.1 会获得两年的 BUG 修复及三年的安全性修复，此策略也使 Laravel 能更好的服务于较大型的企业客户及消费者。

PSR-2

PSR-2 代码风格指南已经被 Laravel 框架采用为默认的代码风格指南。此外，所有的生成器都已进行更新，生成的文件将兼容 PSR-2 规范。

文档 (Documentation)

Laravel 文档的每一页已被精心审阅，并得到显著的改善。所有的代码例子也进行了严密检查，使其有更高的上下文关联性。

事件广播 (Event Broadcasting)

WebSockets 技术越来越多的被现代 Web 应用使用，当服务器上一些数据更新，WebSocket 会实时发送一个消息给客户端，实现即时更新用户状态功能。

Laravel 的事件广播机制很好的支持了此类应用的开发，广播事件允许服务器端代码和 JavaScript 框架间分享相同的事件名称。

了解更多关于事件广播，请查阅事件的文档。

中间件参数 (Middleware Parameters)

中间件支持接收自定义传参，例如要在运行特定操作之前，检查当前登录的用户是否具备「某角色」，可以创建 RoleMiddleware 来接收角色名称作为传参：

<?php

namespace App\Http\Middleware;

use Closure;

class RoleMiddleware
{
    /**
     * 运行请求过滤。
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Closure  $next
     * @param  string  $role
     * @return mixed
     */
    public function handle($request, Closure $next, $role)
    {
        if (! $request->user()->hasRole($role)) {
            // 重定向...
        }

        return $next($request);
    }

}

在路由中使用冒号 : 来区隔中间件名称与参数，多个参数可使用逗号作为分隔：

Route::put('post/{id}', ['middleware' => 'role:editor', function ($id) {
    //
}]);

关于中间件的更多信息，请查阅中间件的文档。

测试改进 (Testing Overhaul)

Laravel 内置的测试功能已得到显著的改善，新版本提供了简明的接口与应用程序进行交互，响应检查也变得更加轻松。

例如下方的测试：

public function testNewUserRegistration()
{
    $this->visit('/register')
         ->type('Taylor', 'name')
         ->check('terms')
         ->press('Register')
         ->seePageIs('/dashboard');
}

关于测试的更多信息，请查阅测试的文档。

模型工厂 (Model Factories)

Laravel 的模型工厂提供一种简单的方式来创建仿真 Eloquent 模型。

在为 Eloquent 模型定义一组「默认」填充字段后，即可为测试，或者数据填充生成测试模型实例。

另外，模型工厂支持使用 Faker 来生成随机数据：

$factory->define(App\User::class, function ($faker) {
    return [
        'name' => $faker->name,
        'email' => $faker->email,
        'password' => str_random(10),
        'remember_token' => str_random(10),
    ];
});

更多关于模型工厂的信息，请查阅它的文档。

Artisan 的改进 (Artisan Improvements)

Artisan 命令现支持类似于命名路由的定义，以简单易懂的形式来定义命令行的参数及选项。

举个例子，你可以定义一个简单的命令及它的参数和选项，如下：

/**
 * 命令行的名字及署名。
 *
 * @var string
 */
protected $signature = 'email:send {user} {--force}';

更多关于定义 Artisan 命令的消息，请参考 Artisan 的文档。

文件夹结构 (Folder Structure)

为了更方便理解，app/Commands 目录已经被更名为 app/Jobs。

此外，app/Handler 目录已经被合并成一个只包含事件侦听器的 app/Listeners 目录中。

这不是一个重大的改变，你不必更新成新的文件夹结构也能使用 Laravel 5.1。

加密 (Encryption)

在 Laravel 之前的版本，加密是通过 mcrypt PHP 扩展进行处理。不过，从 Laravel 5.1 起，加密将采用更积极维护的 openssl 扩展进行处理。

Laravel 5.0

Laravel 5.0 引进了新的应用程序架构。新架构允许 Laravel 创建更加健壮的应用程序，新架构全面采用新的自动加载标准（PSR-4）。

以下是一些主要变化：

新的目录结构 (New Folder Structure)

旧的 app/models 目录已经完全被移除。对应的，你所有的代码都放在 app 目录下。

默认情况下使用 App 命名空间。可以使用 app:name Artisan 命令对默认命名空间进行修改。

控制器、中间件，以及表单请求（Laravel 5.0 中新型态的类），分门别类的放在 app/Http 目录下，因为他们都与应用程序的 HTTP 传输层相关。除了一个路由设置的文件外，所有中间件现都分开为独自的类文件。

app/Providers 目录取代了旧版 Laravel 4.x app/start 里的文件。这些服务提供者为应用程序提供了各种引导功能，像是错误处理，日志纪录，路由加载等等。当然，你可以任意的创建新的服务提供者。

应用程序的语言文件和视图都被移到 resources 目录下。

契约 (Contracts)

所有 Laravel 组件实现所用的接口都放在 illuminate/contracts 文件夹中，他们没有其他依赖。这些方便集成的接口，让依赖注入变得低耦合，可简单作为 Laravel Facades 的替代选项。

更多关于 contracts 的信息，参考完整文档。

路由缓存 (Route Cache)

如果你的应用程序全部使用控制器路由，新的 route:cache Artisan 命令可大幅度地优化路由注册寻找速度。

这对于拥有 100 个以上路由规则的应用程序来说很有用，可以 大幅度地 加快应用程序路由部分的处理速度。

路由中间件 (Route Middleware)

除了像 Laravel 4 风格的路由「过滤器」，Laravel 5 现在有 HTTP 中间件，而原本的认证和 CSRF 「过滤器」已经改写成中间件。中间件提供了单个、一致的接口取代了各种过滤器，让你在请求进到应用程序前，可以简单地检查甚至拒绝请求。

更多关于中间件的信息，参考完整文档。

控制器方法注入 (Controller Method Injection)

除了之前有的类的构造函数注入外，你现在可以在控制器方法中使用依赖注入。服务容器会自动注入依赖，即使路由包含了其它参数也不成问题：

public function createPost(Request $request, PostRepository $posts)
{
    //
}

认证基本架构 (Authentication Scaffolding)

认证系统默认包含了用户注册，认证，以及重设密码的控制器，还有对应的视图，视图文件存放在 resources/views/auth。

除此之外，「users」数据表迁移也默认包含在框架中。这些简单的资源，可以让你把心思放在产品开发上，而不用陷在编写认证模板的泥潭。

认证相关的视图可以通过 auth/login 以及 auth/register 路由访问。

App\Services\Auth\Registrar 会负责处理用户认证和注册用户的相关逻辑。

事件对象 (Event Objects)

你现在可以将事件定义成对象，而不是仅使用字符串。例：

<?php

class PodcastWasPurchased
{
    public $podcast;

    public function __construct(Podcast $podcast)
    {
        $this->podcast = $podcast;
    }
}

这个事件可以像一般使用那样被派发：

Event::fire(new PodcastWasPurchased($podcast));

当然，你的事件处理会收到事件的对象而不是数据的列表：

<?php

class ReportPodcastPurchase
{
    public function handle(PodcastWasPurchased $event)
    {
        //
    }
}

更多关于使用事件的信息，参考完整文档。

命令及队列 (Commands / Queueing)

除了 Laravel 4 形式的队列任务，Laravel 5 还支持命令对象直接作为队列任务。这些命令放在 app/Commands 目录下。下面是个例子的命令：

<?php

class PurchasePodcast extends Command implements SelfHandling, ShouldBeQueued
{

    use SerializesModels;

    protected $user, $podcast;

    /**
     * Create a new command instance.
     *
     * @return void
     */
    public function __construct(User $user, Podcast $podcast)
    {
        $this->user = $user;
        $this->podcast = $podcast;
    }

    /**
     * Execute the command.
     *
     * @return void
     */
    public function handle()
    {
        // Handle the logic to purchase the podcast...
    }
}

Laravel 的基底控制器使用了新的 DispatchesCommands trait，让你可以简单的派发命令运行：

$this->dispatch(new PurchasePodcastCommand($user, $podcast));

当然，你也可以将命令视为同步运行（而不会被放到队列里）的任务。事实上，「命令总线」是个不错的设计模式，可以封装应用程序需要运行的复杂任务。更多相关的信息，参考 command bus 文档。

数据库队列 (Database Queue)

database 队列驱动现在已经包含在 Laravel 中了，提供了简单的本地端队列驱动，除了数据库相关软件外不需安装其它扩展包，完全开箱即用。

Laravel 调度器 (Laravel Scheduler)

在过去，开发者是在 crontab 里配置任务调度的。然而，这是件很头痛的事情，因为你的命令行调度不在版本控制中，并且必须登录到服务器里才能添加新的 Cron 设置。

Laravel 命令行调度的存在，就是为了改变这一情况。

命令行调度系统让你在 Laravel 里定义富有表达性的命令调度，而且只需要在服务器里设置一个 Cron 设置即可。

看起来如下：

$schedule->command('artisan:command')->dailyAt('15:00');

参考完整文档学习所有调度相关知识。

Tinker / Psysh

php artisan tinker 命令现在使用 Justin Hileman 的 Psysh，一个 PHP 更强大的 REPL。如果你喜欢 Laravel 4 的 Boris，你也会喜欢上 Psysh。更好的是，它可以在 Windows 上运行！

赶快尝试下吧：

php artisan tinker

DotEnv

比起一堆令人困惑的、嵌套的环境配置文件，Laravel 5 现在使用了 Vance Lucas 的 DotEnv。

这个扩展包提供了超级简单的方式管理配置文件，并且让 Laravel 5 环境侦测变得轻松。更多的细节，参考完整的配置文件文档。

Laravel Elixir

Jeffrey Way 的 Laravel Elixir 提供了一个流畅、口语化的接口，可以编译以及合并静态资源。如果你曾经因为学习 Grunt 或 Gulp 而被吓到，不必再害怕了。Elixir 让使用 Gulp 编译 Less、Sass 及 CoffeeScript 变得简单。它甚至可以帮你运行测试！

更多关于 Elixir 的信息，参考完整文档。

Laravel Socialite

Laravel Socialite 是可选的，兼容 Laravel 5.0 以上的 OAuth 认证扩展包。目前 Socialite 支持 Facebook、Twitter、Google 以及 GitHub。它写起来是这样的：

public function redirectForAuth()
{
    return Socialize::with('twitter')->redirect();
}

public function getUserFromProvider()
{
    $user = Socialize::with('twitter')->user();
}

不再需要花上数小时编写 OAuth 的认证流程，只要几分钟！查看完整文档里有所有的细节。

文件系统集成 (Flysystem Integration)

Laravel 现在包含了强大的 Flysystem 文件系统（一个文件系统的抽象函数库）。

文件系统以抽象的概念，把本地端文件系统、Amazon S3 和 Rackspace 云存储集成在一起，统一且优雅的 API！

现在要将文件存到 Amazon S3 相当简单：

Storage::put('file.txt', 'contents');

更多关于 Laravel 文件系统集成，参考完整文档。

表单请求 (Form Requests)

Laravel 5.0 引进了 form requests，是继承自 Illuminate\Foundation\Http\FormRequest 的类。这些 request 对象可以和控制器方法依赖注入结合使用，提供一个不需模版的方法，来验证用户输入。让我们深入点，看一个 FormRequest 的例子：

<?php

namespace App\Http\Requests;

class RegisterRequest extends FormRequest
{
    public function rules()
    {
        return [
            'email' => 'required|email|unique:users',
            'password' => 'required|confirmed|min:8',
        ];
    }

    public function authorize()
    {
        return true;
    }
}

定义好类后，我们可以在控制器动作里使用类型提示进行依赖注入：

public function register(RegisterRequest $request)
{
    var_dump($request->input());
}

当 Laravel 的服务容器辨别出要注入的类是个 FormRequest 实例，该请求将会被 自动验证。意味着，框架会自动根据你在 form request 类里自定的规则，对请求进行检验。当控制器动作调用时，你可以安全的假设 HTTP 的请求输入己被验证过。

甚至，若这个请求验证不通过，一个 HTTP 重定向（可以自定义），会自动发出，错误消息可以被闪存到 session 中或是转换成 JSON 返回。表单验证再简单不过了。 更多关于 FormRequest 验证，请参考文档。

简易控制器请求验证 (Simple Controller Request Validation)

Laravel 5 基底控制器包含一个 ValidatesRequests trait。这个 trait 包含了一个简单的 validate 方法可以验证请求。如果对你的应用程序来说 FormRequests 太复杂了，可以考虑使用手动验证方法：

public function createPost(Request $request)
{
    $this->validate($request, [
        'title' => 'required|max:255',
        'body' => 'required',
    ]);
}

如果验证失败，会抛出异常以及返回适当的 HTTP 响应到浏览器。验证错误信息会被闪存到 session 里！而如果请求是 AJAX 请求，Laravel 会自动返回 JSON 格式的验证错误信息。

更多关于这个新方法的信息，参考这个文档。

新的生成器 (New Generators)

为了响应新的应用程序默认架构，框架新增了许多 Artisan generator 命令。使用 php artisan list 查看完整的命令列表。

配置文件缓存 (Configuration Cache)

你现在可以通过 config:cache 命令将所有的配置文件缓存在单个文件中，这样在一定程度上会加快框架的启动效率。

Symfony VarDumper

广为使用的 dd 辅助函数，用作在调试时输出变量信息，现采用令人惊艳的 Symfony VarDumper 扩展包。它提供了颜色标记的输出，甚至数组可以自动缩合。在项目中试试下列代码：

dd([1, 2, 3]);

Laravel 4.2

此发行版本的完整的变更列表可以通过运行 php artisan changes 命令来获取，或者 Github 上的更动纪录。此纪录仅含括主要更新和此发行的更动部分。

附注: 在 4.2 开发期间，许多小的 BUG 修正与功能强化被整合至各个 4.1 的子发行版本中。所以，也请一并检查 Laravel 4.1 版本的更新列表。

PHP 5.4 需求

Laravel 4.2 需要 PHP 5.4 以上的版本。此 PHP 更新版本让我们可以使用 PHP 的新功能：traits 来为像是 Laravel 收银台来提供更具表达力的接口。PHP 5.4 也比 PHP 5.3 带来显著的速度及性能提升。

Laravel Forge

Larvel Forge，一个网页应用程序，提供一个简单的接口让你创建管理云端上的 PHP 服务器，像是 Linode、DigitalOcean、Rackspace 和 Amazon EC2。

支持自动化 nginx 设置、SSH 密钥管理、Cron job 自动化、通过 NewRelic & Papertrail 服务器监控、「推送部署」、Laravel queue worker 设置等等。Forge 提供最简单且更实惠的方式来部署所有你的 Laravel 应用程序。

默认 Laravel 4.2 的安装里，app/config/database.php 配置文件已为 Forge 设置完成，让你更方便的完成新平台上的全新应用程序的部署。

关于 Laravel Forge 的更多信息可以在官方 Forge 网站上找到。

Laravel Homestead

Laravel Homestead 是一个健全的 Laravel 和 PHP 应用程序 Vagrant 环境。软件依赖都已提前准备好，可以极快的被启用。

Homestead 包含 Nginx 1.6、PHP 5.5.12、MySQL、Postres、Redis、Memcached、Beanstalk、Node、Gulp、Grunt 和 Bower。Homestead 包含一个简单的 Homestead.yaml 配置文件，允许你在单个封装包中管理多个 Laravel 应用程序。

默认的 Laravel 4.2 安装中包含的 app/config/local/database.php 配置文件已经为你配置好了 Homestead 的数据库连接。让 Laravel 初始化安装与设置更为方便。

官方文档已经更新并包含在 Homestead 文档中。

Laravel 收银台 (Laravel Cashier)

Laravel 收银台是一个简单、具表达性的资源库，用来管理 Stripe 的订阅服务。虽然安装此组件是可选的，我们仍然将收银台文档包含在主要 Laravel 文档中。新版本的收银台带来了数个错误修正、多货币支持还有支持了最新的 Stripe API。

常驻程序 (Daemon Queue Workers)

Artisan queue:work 命令现在支持 --daemon 参数让 worker 可以作为「常驻程序」启用。代表 worker 可以持续的处理队列工作，而不需要重启框架。这让一个复杂的应用程序对 CPU 的使用率有显著的降低。

更多关于 Queue Workers 常驻程序信息请详阅 queue 文档。

Mail API Drivers

Laravel 4.2 为 Mail 类采用了新的 Mailgun 和 Mandrill API 驱动。对许多应用程序而言，他提供了比 SMTP 更快也更可靠的方法来递送邮件。新的驱动使用了 Guzzle 4 HTTP 资源库。

软删除 Traits (Soft Deleting Traits)

PHP 5.4 的 traits 提供了一个更加简洁的软删除架构和全局作用域，这些新架构为框架提供了更有扩展性的功能，并且让框架更加简洁。

更多关于软删除的文档请见: Eloquent documentation。

Convenient Auth & Remindable Traits

得益于 PHP 5.4 traits，我们有了一个更简洁的用户认证和密码提醒接口，这也让 User 模型文档更加精简。

“简易分页 (Simple Paginate)”

一个新的 simplePaginate 方法已被加入到查找以及 Eloquent 查找器中。让你在分页视图中，使用简单的「上一页」和「下一页」链接查找更为高效。

迁移确认 (Migration Confirmation)

在正式环境中，破坏性的迁移动作将会被再次确认。如果希望取消提示字符确认请使用 --force 参数。

Laravel 4.1

完整更动列表 (Full Change List)

此发行版本的完整更动列表，可以在版本 4.1 的安装中命令行运行 php artisan changes 获取，或者浏览 Github 更新文件中中了解。其中只记录了该版本比较主要的强化功能和更动。

新的 SSH 组件 (New SSH Component)

一个全新的 SSH 组件在此发行版本中登场。此功能让你可以轻易的 SSH 至远程服务器并运行命令。更多信息，可以参阅 SSH 组件文档。

新的 php artisan tail 命令就是使用这个新的 SSH 组件。更多的信息，请参阅 tail 命令集文档。

Boris In Tinker

如果你的系统支持 Boris REPL，php artisan thinker 命令将会使用到它。系统中也必须先行安装好 readline 和 pcntl 两个 PHP 扩展包。如果你没这些扩展包，从 4.0 之后将会使用到它。

Eloquent 强化 (Eloquent Improvements)

Eloquent 添加了新的 hasManyThrough 关系链。想要了解更多，请参见 Eloquent 文档。

一个新的 whereHas 方法也同时登场，他将允许检索基于关系模型。

数据库读写分离 (Database Read / Write Connections)

Query Builder 和 Eloquent 目前通过数据库层，已经可以自动做到读写分离。更多的信息，请参考文档。

队列排序 (Queue Priority)

队列排序已经被支持，只要在 queue:listen 命令后将队列以逗号分隔送出。

失败队列作业处理 ( Failed Queue Job Handling)

现在队列将会自动处理失败的作业，只要在 queue:listen 后加上 --tries 即可。更多的失败作业处理可以参见队列文档。

缓存标签 (Cache Tags)

缓存「区块」已经被「标签」取代。缓存标签允许你将多个「标签」指向同一个缓存对象，而且可以清空所有被指定某个标签的所有对象。更多使用缓存标签信息请见缓存文档。

更具弹性的密码提醒 (Flexible Password Reminders)

密码提醒引擎已经可以提供更强大的开发弹性，如：认证密码、显示状态消息等等。使用强化的密码提醒引擎，更多的信息请参阅文档。

强化路由引擎 (Improved Routing Engine)

Laravel 4.1 拥有一个完全重新编写的路由层。API 一样不变。然而与 4.0 相比，速度快上 100%。整个引擎大幅的简化，且路由表达式大大减少对 Symfony Routing 的依赖。

强化 Session 引擎 (Improved Session Engine)

此发行版本中，我们亦发布了全新的 Session 引擎。如同路由增进的部分，新的 Session 层更加简化且更快速。我们不再使用 Symfony 的 Session 处理工具，并且使用更简单、更容易维护的自定义解法。

Doctrine DBAL

如果你有在你的迁移中使用到 renameColumn，之后你必须在 composer.json 里加 doctrine/dbal 进依赖扩展包中。此扩展包不再默认包含在 Laravel 之中。

最后更新：2016.09.21

Composer 入门教程

Sat, 30 Apr 2016 00:00:00 +0800

Composer 是 PHP 的一个依赖管理工具。它允许你申明项目所依赖的代码库，并且能够在项目中自动安装、升级这些代码库。

依赖管理

Composer 不是一个软件包管理器（类似APT、YUM），虽然它涉及到packages 或者 libraries 概念，但是它是基于你项目来管理依赖的，依赖代码只会安装在一个文件夹下（例如 vendor文件夹），他不会将依赖代码作为系统全局来安装。当然，虽然 Composer 支持全局项目，但它仅仅是一个依赖管理工具。

假设

你的项目依赖其他第三方代码库。
这个第三方代码库同时又依赖其他的代码库。

Composer

你只需通过 Composer 声明你项目所依赖的代码库。
Composer 会自动找出所有你需要安装的代码库，并将它们下载到你的项目中。

系统要求

运行 Composer 需要 PHP 5.3.2+ 以上版本。一些敏感的 PHP 设置和编译标志也是必须的，但对于任何不兼容项安装程序都会抛出警告。

我们将从包的来源直接安装，而不是简单的下载 zip 文件，你需要 git 、 svn 或者 hg ，这取决于你载入的包所使用的版本管理系统。

Composer 是多平台的，我们努力使它在 Windows 、 Linux 以及 OSX 平台上运行的同样出色。

安装 - Linux / Unix / OSX

下载 Composer 的可执行文件

Composer 提供了一个方便的安装程序，你可以直接从命令行执行。你可以免费从官网或者 GitHub 下载到这个可执行文件。如果你想知道更多关于程序的内部运作，你可以直接查看，他是纯文本的PHP源码。

总之，你有2种方式来安装 Composer。一种是局部安装，仅用于具体项目的使用，另一种是全局安装，所有项目都能使用。

局部安装

局部安装 Composer 只会安装到你项目的文件夹下。详情安装方法请阅读官方下载页的说明

命令行安装（二选一）

curl -sS https://getcomposer.org/installer | php

php -r "readfile('https://getcomposer.org/installer');" | php

安装程序会检查一些 PHP 设置，然后下载 composer.phar 文件到你的工作目录。这个文件是 Composer 的二进制文件，一个 PHAR 文件 (PHP archive)。这个 composer.phar 文件可以在命令行中执行的。

运行 Composer 程序

php composer.phar

自定义安装路径（选做）

你也可以在安装 Composer 时通过 --install-dir 参数指定安装路径，通过 --filename 参数指定文件名。

curl -sS https://getcomposer.org/installer | php -- --install-dir=bin --filename=composer

现在你可以使用 php bin/composer 命令来运行 composer 了。

全局安装

你可以将此文件放在任何地方。如果你把它放在系统的 PATH 目录中，你就能在全局访问它。在类 Unix 系统中，你甚至可以在使用时不加 php 前缀。

你可以执行这些命令让 composer 在你的系统中进行全局调用：

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

注意： 如果上诉命令因为权限执行失败，请使用 sudo 再次尝试运行 mv 那行命令。

注意： 在一些系统中 /usr 这个目录可能不存在，请手动创建 mkdir -p /usr/local/bin

注意： 更多关于 PATH 环境变量的内容请访问维基百科或者自行 Google。

现在只需要运行 composer 命令就可以使用 Composer 而不需要输入php composer.phar。

安装 - Windows

使用安装程序

这是将 Composer 安装在你机器上的最简单的方法。

下载并且运行 Composer-Setup.exe，它将安装最新版本的 Composer ，并设置好系统的环境变量，因此你可以在任何目录下直接使用 composer 命令。

手动安装

首先从官方下载页面下载最新版本的 composer.phar ，并将这个文件移动到 C:\Windows\System32 目录。

然后创建一个 composer.bat 文件，同时这个文件也移动到 C:\Windows\System32 目录。

C:\bin>echo @php "%~dp0composer.phar" %*>composer.bat

最后验证是否安装成功

C:\Users\username>composer -V
Composer version 1.0.0 2016-01-10 20:34:53

使用 Composer

声明依赖关系

比方说，你正在创建一个项目，你需要一个库来做日志记录。你决定使用 monolog。为了将它添加到你的项目中，你所需要做的就是创建一个 composer.json 文件，其中描述了项目的依赖关系。

{
    "require": {
        "monolog/monolog": "1.2.*"
    }
}

我们只要指出我们的项目需要一些 monolog/monolog 的包，从 1.2 开始的任何版本。

声明依赖关系后，接下来解决和下载依赖，这里将下载 monolog 到 vendor/monolog/monolog 目录，请执行 install 命令。

php composer.phar install

如果你进行了全局安装，并且没有 phar 文件在当前目录，请使用下面的命令代替：

composer install

自动加载

除了库的下载，Composer 还准备了一个自动加载文件，它可以加载 Composer 下载的库中所有的类文件。使用它，你只需要将下面这行代码添加到你项目的引导文件中：

require __DIR__ . '/vendor/autoload.php';

更多基础用法，请务必阅读基本用法章节。

PHP PSR编码规范

Sun, 19 Jul 2015 00:00:00 +0800

本文档是PHP互操作性框架制定小组（PHP-FIG :PHP Framework Interoperability Group）制定的PHP编码规范（PSR:Proposing a Standards Recommendation）中译版。

目前官方已制定的规范包括以下六份文件：PSR-0 (已弃用)、PSR-1、PSR-2、PSR-2补充、PSR-3

本文转自于《PHP-FIG PSR中文版》

PHP技术札记6：PHP中的函数

Mon, 21 Apr 2014 00:00:00 +0800

一、函数的声明

1、语法结构

function 函数名 (参数列表)
{
    函数体; //可选
    返回值; //return可选
}

参数列表用逗号隔开，勿遗漏$变量符号
函数名不区分大小写，规则与变量一致
函数调用才执行，可先调用后声明
函数名不能重名，包括系统函数

2、函数调用

function sum($x,$y) //形参：在声明函数时声明的参数
{
    // $x = 1; //如果在函数内对参数赋值，则会覆盖实参。
    // $y = 2;
    $sum = 0;
    $sum = $x + $y;
    return $sum; //执行到return函数结束，后面不再执行
}

sum();
sum(2,2); //实参：在调用函数时传递给形参的数值
echo sum(2,2); //通过return返回数据可作为值使用

二、函数中的变量

1、变量范围

局部变量：函数内部声明与使用的变量
全局变量：在函数外声明，脚本任何地方均可以使用

在PHP函数中使用全局变量，要通过global关键字将这个全局变量包含到函数中才能使用

$a = 1;
$b = 2;
function demo($a = '')
{
    //global 须放在前面
    //global $a,$b global 可包含多个全局变量
    //$GLOBALS['a'] //声明全局变量 方法二
    global $a;
    $a += 5;
    echo $a;
}

demo();

2、PHP静态变量

静态变量可以在同一个函数中多次调用中共用
静态变量只能在函数或类中声明，不能在全局声明。

function demo($a = '')
{
    static $a = 0; //定义静态变量
    $a++;
    echo "$a <br/>";
}
demo(); //输出1
demo(); //输出2

3、变量函数

$var = 'hello'; //变量名后面右括号，就寻找与变量值同名的函数
$var(); //等价于 hello();

三、函数分类及声明

1、函数分类

//常规函数
bool copy（string source,string dest)

//带mixed，表示可以传任何类型的数据
bool chown(string filename,mixed user)

//带&参数的函数，这个参数只能是变量，变量值是动态的
//对数组进行排序，数组的索引保持和单元的关联
bool arsort ( array &$array [, int $sort_flags ] )
$fruits = array('a', 'c', 'b');
arsort($fruits);
var_dump($fruits);

//默认函数，即带[]中括号的函数，表示参数可选，若没有传值则使用默认值
//如果调用没有赋值，又没有初值则出现警告
function demo($a=1,$b=2)
{
    #code
}
demo();

//带有...参数的函数，表示可以传任意多个参数
//在数组开头插入一个或多个单元 
int array_unshift ( array &$array , mixed $var [, mixed $... ] )

2、声明多个参数函数

func_num_args()： 返回传递到函数的参数数目

function Test()
{
    echo func_num_args();
}
Test('a','b','c');  // 3

func_get_arg()： 返回参数列表中的第N个参数

function Test()
{
    echo func_get_arg('1'); 
}
Test('a','b','c'); //b

使用实例

function cls_mysql()
{
    $mysql = func_get_args();
    $conn = mysql_connect($mysql['0'], $mysql['1'], $mysql['2']);
}
cls_mysql('localhost:3306', 'root', '123456');

3、函数注释规范

    /**
     * 用用演示函数 //函数功能，决定是否使用
     * 
     * @static
     * @access public
     * @param string $attributeName 属性名称 //函数参数，决定怎样调用
     * @return string //函数的返回值，决定调用后怎么处理
     */
    public function demo($attributeName)
    {
        $attributeName = 'abc';
        return $attributeName
    }

四、Callback 回调函数

我们自定义一个函数A，但是我们不直接去调函数A，而是在函数B中去调用函数A，函数B通过接收函数A的名字和参数来实现对函数A的调用，函数A称为回调函数。


function A($x,$y)
{
    return $x*$y;
}
function B($a,$b,$fun)
{
    return $a+$b+$fun($a,$b);
}
echo B(2,3,"A");

PHP回调函数的实现方法

php提供了两个内置函数 call_user_func() 和 call_user_func_array() 提供对回调函数的支持

//mixed call_user_func_array 以数组的形式接收回调函数的参数
mixed call_user_func_array ( callable $callback , array $param_arr )
call_user_func_array('f1',array('A','B')); 

//call_user_func的参数个数根据回调函数的参数来确定
mixed call_user_func ( callable $callback [, mixed $parameter [, mixed $... ]] )
call_user_func_array('f1','A','B');

实例：

//普通全局函数
function f1($arg1,$arg2)
{
    echo $arg1."<br/>".$arg2."<br/>";
}

echo "通过call_user_func_array调用函数f1：<br/>";
call_user_func_array('f1',array('A','B'));

echo "通过call_user_func调用函数f1：<br/>";
call_user_func('f1','C','D');

//类
class myClass
{
    public $name;
    function show($arg1)
    {
        echo '参数名:'.$arg1."<br/>";
        echo '对象中的成员名:'.$this->name;
        echo "<br/>";
    }
    function show1($arg1,$arg2)
    {  
        echo $arg1."<br/>".$arg2."<br/>";
    }
    public static function show2($arg1,$arg2)  
    {
        echo $arg1."<br/>".$arg2."<br/>";
    }
}

echo "调用类中非静态成员函数，该成员函数中有this调用了对象中的成员：";
$a = new myClass;
$a->name = 'F';
call_user_func_array(array($a,'show'),array('E'));

echo "调用类中非静态成员函数，该函数没有调用对象中的成员,没有this：";
call_user_func_array(array('myClass','show1'),array('G','H'));

echo "调用类中静态成员函数：";
call_user_func_array(array('myClass','show2'),array('I','J'));

五、内部函数

在函数内部再声明函数，目的是在函数内部调用，用来帮助外部函数完成一些子功能。

PHP技术札记5：PHP流程控制分支结构

Sun, 20 Apr 2014 00:00:00 +0800

一、PHP流程控制概述

1、分支结果（条件结构）

//单路分支：
if (condition) { //花括号后可以没有分号;
    # code...
}

//双路分支
if (condition) {
    # code...
} else {
    # code...
}

//多路分支
if (condition) {
    # code...
} elseif(condition) { //elseif 可写成else if
    # code...
} else {
    # code...
}

2、switch 多路分支结构

判断范围用if结构，单个值用switch

switch (variable) { //变量用整型和字符串
    case 'value1':  
    case 'value2':  //可以有多个case
        # code...
        break;      //如果不加break，下一个case会继续执行
    case 'value3':
        # code...
        break;
    default:        //默认值，可有可无
        # code...
        break;
}

二、PHP循环语句

1、while 循环

while (condition) { //先判断条件再执行
    # code...
}

2、do while 循环

do { //先执行再判断条件
    # code...
} while (condition); //注意不要遗漏分号

3、for 循环

for ($i=0; $i < ; $i++) {  //一般用于计数，两个分号不能省略
    # code...
}

实例：99乘法表

for ($i=1; $i < 10; $i++) { 
    for ($ii=1; $ii <= $i; $ii++) { 
        echo "$ii X $i = ".$ii*$i.' ';
    }
    echo "<br/>";
}

三、退出循环语句

//退出本次循环，下次循环也不再进行
break

//退出本次循环，下次循环继续，只能用于循环体内(for,while,do-while)
coninue

//完全退出程序
exit

//函数执行返回值，结束函数的语句
return

退出多层循环

break 1  // 退出当前循环
break 2  // 退出2层循环
continue 2

错误实例

$i = 0;
while ($i < 10){
    if ($i == 5)
       continue;
    echo "$i";
    $i++; //注意这里的i++不会被执行，会产生死循环
}

PHP技术札记4：PHP的运算符与表达式

Sat, 19 Apr 2014 00:00:00 +0800

一、运算符的分类

1、按操作数分类

!true // 一元运算符
$a+$b // 二元运算符
true ? 1:0 // 三元运算符

2、按操功能分类

（1）算术运算符

+、-、x、/、%(取余)

（2）字符串运算符

$a = 'abc'.'efg';

（3）赋值运算符

= // 简单赋值
+=、-=、X=、/=、%=、.= // 复合赋值
++($a++、++$a)、 --($a--、--$a) // 递增递减
&($a = 1;$b = &a) // 引用赋值

（4）比较运算符

==、 ===(恒等于)、 !=、 !===、 <>(不等于)、 <、 >、 <=、 >=

（5）逻辑运算符

// 括号内的比括号外的优先级高
&&(and)、 ||(or)、 !(not)、 xor(异或)、

（6）位运算符

&(按位与)、 |(按位或)、 ~(按位非)、 ^(按位异或)、 <<(左位移)、 >>(右位移)

二、算术运算符

%取余，常见用法：1）整除运算 2）控制取值范围

实例：判断是否为闰年（四年一闰，百年不闰，四百年再闰）

// %会把两边的数转成整型后在整除
// %两边不能用小数或负数
if ((($year%4 == 0) && ($year%100 != 0)) || $year%400 == 0)
  echo "闰年";
else
  echo "平年";

三、赋值运算符

//先自身加10，然后赋值给自己，等价于 $a=$a+10
$a += 10; 

//前置递增递减，先递增递减再赋值
++$a

//先赋值，再递增递减
$a++

//实例
$a = 10;
$b = $a++
$c = --$b
结果：a=11 b=9 c=9

四、逻辑运算符

xor异或：相同为假（两个真或两个假=假），不同为真（一真一假=假） Tips：注意与or区别，or两个真=真

逻辑运算符短路

1、&& //一个为假，则后面不作运算，一定为假
2、|| //一个为真，则后面不作运算，一定为真

fopen ("test.php","r") or die("失败");

Tips：为运算符 & | 没有短路特性

五、位运算符

位操作：将整型转为32位二进制，字符串转为ANSCA码来处理

PHP技术札记3：PHP的数据类型与常量使用

Fri, 18 Apr 2014 00:00:00 +0800

一、PHP数据类型相互转换

1、强制转换

// bool，int，float，string，array，object，null
bool settype ( mixed $var , string $type )

1）会改变原变量的类型

$a= "123a"; // string
settype($a, "int"); // 勿遗漏双引号
var_dump($a);

2）在赋值前定义，不改变原变量类型

$a = "123abc";
$b = (int)"123abc";
var_dump($a);

Tips：避免内存溢出，整型4字节(2.147E9），浮点型8字节

2、自动转换

根据运行环境自动转换，例如加号“+”。如果任何一个操作数是浮点数，则所有的操作数都被当成浮点数，结果也是浮点数。

$foo = “0″;  // $foo 是字符串 (ASCII 48)
$foo += 2;   // $foo 现在是一个整数 (2)
$foo = $foo + 1.3;  // $foo 现在是一个浮点数 (3.3)
$foo = 5 + “10 Small Pigs”;     // $foo 是整数 (15)

3、变量测试函数

is_bool()、is_numeric()、is_float()、is_int()...
is_scalar() //检测变量是否是一个标量

二、常量的声明与使用

//定义后不能改变，可在任意地方访问
//默认大小写敏感，习惯大写
//常量值只能用标量(int、float、string、bool）
//常量必须声明时就赋值
define("常量名","值")

检查常量是否存在

bool defined ( string $name )
var_dump(defined('a')); //勿遗漏了引号

PHP技术札记2：PHP中使用变量

Thu, 17 Apr 2014 00:00:00 +0800

一、PHP 变量简介

1、语法

//PHP是弱类型语言，变量类型由存储的值决定
//强类型语言：int a = 1
$变量名 = 值

2、命名规则

不能数字开头
不能使用PHP运算符(+-x/%&)
可以使用PHP关键字
区分大小写（php只有变量、常量区分大小写）
驼峰命名法：aaBbCc（第一个单词首字母小写）

3、可变变量

变量名可动态设置，例如：$$var

4、引用赋值

$a=1;
$b=&$a; //将$a内存地址的值赋给$b
$a=2;
echo $b //最后值等于1

二、变量数据类型

1、四种标量

int（整型）、bool（布尔型）、float,double（浮点刑）、string（字符串）

2、二种复合型

数组：array()
对象：object 
例如：$var = new mysqlli('localhost','root','123455')

3、二种特殊类型

resource（资源） 例如：$var = fopen('test.php','r')
Null（空类型） 不区分大小写

三、常用函数

isset() //变量是否存在，值为null表示不存在
unset() //释放变量
var_dump() //检查变量或值的类型
empty() //变量不存在或者为空时返回true
settype($a,int) //设置变量类型
gettype() //获取变量类型

四、变量声明方法

$int = 10 //整型4字节，最大值2³²
$float = 3.14E⁴ //浮点型等于3.14X10⁴
$bool = false //true为真
$str = "string" //双引号中可以解析变量和转义字符

//不可以使用转义字符，但可以转义单引号本身 例如 $str = 'a\'a\''
$str = 'string'

使用定界符声明字符串

PHP技术札记1：PHP基本语法

Wed, 16 Apr 2014 00:00:00 +0800

一、PHP 标记

1、XML风格

  <_?php echo "hello world";?>

2、简短风格

  <_? echo "hello world"; ?>

3、script 风格

  <script language="php">echo "hello world";</script>

二、PHP 注释

1、单行注释： // （C++风格） 2、多行注释：/* */ （C风格） 3、单行脚本注释：# （shell风格）

Tips：注释一般写在代码上面

三、PHP 空白

1、空白间隔符

换行（回车）、空格、Tab（制表符）

2、约定习俗

代码片段（2行）、类（2行）、函数（1行）、函数变量与第一条语句（1行）、注释前（1行）

Nginx目录别名(Alias)支持PHP的配置

Fri, 30 Mar 2012 00:00:00 +0800

需求：通过 example.com 访问 /var/data/www ，但通过 example.com/pa 访问的却是 /var/data/phpmyadmin，即保护phpmyadmin不暴露在www目录下。

一、方法一：（不推荐）

简介：这是网上普遍采用的 Rewrite 方式。缺陷：简单的php程序还能应付，复杂一点的程序就 No input file specified

server {
    listen 80;
    server_name example.com;
    
    root /var/data/www;
    index index.html index.php;
    
    location /pa {
        alias /var/data/phpmyadmin;
        index index.html index.php;
    }
    
    location ~ /pa/.+\.php$ {
        rewrite /pa/(.+\.php) /$1 break;
        fastcgi_pass  127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  /var/data/phpmyadmin/$fastcgi_script_name;
        include  fastcgi_params;
    }
    
    location ~ .+\.php.*$ {
        fastcgi_pass  127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root/$fastcgi_script_name;
        fastcgi_param  SCRIPT_FILENAME  $request_filename;
        include  fastcgi_params;
    }
}

二、方法二：（推荐）

简介：完美实现，无副作用。特点：使用了一个叫 $valid_fastcgi_script_name 的变量

server {
    listen 80;
    server_name example.com;

    root /var/data/www;
    index index.html index.php;

    location /pa {
        alias /var/data/phpmyadmin;
        index index.html index.php;
    }

    location ~ /pa/.+\.php.*$ {
        if ($fastcgi_script_name ~ /pa/(.+\.php.*)$) {
            set $valid_fastcgi_script_name $1;
        }
        fastcgi_pass  127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  /var/data/phpmyadmin/$valid_fastcgi_script_name;
        include  fastcgi_params;
    }

    location ~ .+\.php.*$ {
        fastcgi_pass  127.0.0.1:9000;
        fastcgi_index  index.php;
        fastcgi_param  SCRIPT_FILENAME  $document_root/$fastcgi_script_name;
        fastcgi_param  SCRIPT_FILENAME  $request_filename;
        include  fastcgi_params;
    }
}

二、方法三：

简介：在 http://www.zhigang.net/post/1001 上看到的创意方法，即一个站加两个server字段，然后通过反代的方式实现。特定：方法有创意，稍微麻烦点。

Apache2.2 使用 FastCGI 模块方法

Tue, 25 Jan 2011 00:00:00 +0800

一、编译与安装 FastCGI 模块

wget http://www.fastcgi.com/dist/mod_fastcgi-2.4.6.tar.gz
tar -zxf mod_fastcgi-2.4.6.tar.gz
cd mod_fastcgi-2.4.6
cp Makefile.AP2 Makefile
make top_dir=/usr/local/apache
make install top_dir=/usr/local/apache

二、编辑 Apache2.2 配置文件

2.1、载入FastCGI模块

vim /usr/local/apache/conf/httpd.conf

LoadModule fastcgi_module modules/mod_fastcgi.so

2.2、设置php文件后缀及解析器

查找并在 “IfModule mime_module” 内添加下面代码

<IfModule mime_module>
AddHandler php-fastcgi .php 
Action php-fastcgi /fcgi-bin/php-fpm
ScriptAlias /fcgi-bin/ /var/fcgi-bin/
</IfModule>

2.3、添加FastCGIExternalServer及目录属性

<IfModule fastcgi_module>
    FastCGIExternalServer /var/fcgi-bin/php-fpm -host 127.0.0.1:9000
</IfModule>

<Directory "/var/fcgi-bin/">
Options none
Order allow,deny
Allow from all
</Directory>

三、作用原理

首先对 .php 后缀的文件使用 php-fastcgi (可随便起名)解析器。
然后发现php-fastcgi不是内置的解析器。
于是使用 action 指令定义该解析器，它实际上是 /var/php-fastcgi/ 目录下的一个叫 php-fpm 虚拟的文件。
但是 apache 并不知道 /var/php-fastcgi/ 目录下的文件是需要执行的，必须用 ScriptAlias 定义个别名 /fcgi-bin/ 他实际指向/var/fcgi-bin/。（根据上文，ScriptAlias 别名内的文件会被执行，所以上面的action只能为 /fcgi-bin/php-fpm 而不能/var/fcgi-bin/php-fpm
最后哪个虚拟文件其实就是127.0.0.1:9000了（必须全路径，不能使用/fcgi-bin/php-fpm）

Apache2.2 内置CGI 模块使用方法

Mon, 24 Jan 2011 00:00:00 +0800

一、基础知识

1.1、什么是 CGI？

简单说 CGI 是一种口，所有对 CGI 文件的访问请求，Web 服务器必须先作执行处理而不能直接把内容返回浏览器。

1.2、什么是 Apache PMA

Apache PMA，即多路处理模块，详细介绍见，apache2.2 官方文档

apache2.2 默认使用 prefork ，如果需要选择 worker ，那么必须在apache2.2 编译时使用“–with-mpm=” 选项静态编译进核心。可通过"httpd -l"查询当前的PMA模式。

prefork 采用进程的方式，Worker 采用进程与线程混合方式，海量的请求时，prefork 较快但耗资源，worker 相反。

1.3、mod_cgi 和 mod_cgid 区别

Apache PMA 为 prefork 时使用mod_cgi模块，PMA 为worker 时使用mod_cgid模块。详细介绍见文档 Apache Module mod_cgi、Apache Module mod_cgid。即在用户层面，这两个模块本质上是相同的。

二、执行 CGI 的方法

2.1、指定ScriptAlias目录为CGI文件目录

在 ScriptAlias 目录的文件均被认为是 CGI i脚本，另外要设置该目录属性，但无需添加 ExecCGI 选项。

指定目录别名及路径，注意是“ScriptAlias”而不是“Alias”

ScriptAlias /cgi-bin/ "/usr/local/apache/cgi-bin/"

设置该目录属性，绝对路径，千万不要漏了 “Allow from all” 切记！

<Directory "/usr/local/apache/cgi-bin">
    AllowOverride None
    Options None
    Order allow,deny
    Allow from all
</Directory>

2.2、指定特定文件后缀为CGI文件

在 ScriptAlias 目录的文件均被认为是 CGI i脚本，那么目录之外是否可以？可以！但要指定后缀、设置目录属性，且启用ExecCGI选项。

指定后缀有两种方法，一是定义MIME类型为application/x-httpd-cgi，二是使用 AddHandler 或 SetHandler 指令激活内置的 cgi-script 处理器

AddType application/x-httpd-cgi .cgi #方法一
AddHandler cgi-script .cgi #方法二

设置CGI的目录属性，必须在Options指令中启用ExecCGI选项

<Directory "/usr/local/apache/htdocs/cgi-bin">
Options ExecCGI
AllowOverride None
Order allow,deny
Allow from all
</Directory>

Debian/Ubuntu 从源码编译安装 PHP 5.3.4

Thu, 20 Jan 2011 00:00:00 +0800

从 php 5.3.3 起，就可直接使用 PHP-FPM ，不再需要打补丁了。此前已写过《Linux 从源码编译安装 PHP 5》，但是以 mod_php 模块方式，而非 FastCGI 模式运行 php ，并不适用于 Lighttpd、Nginx、LiteSpeed ，而且当时对所有模块都采用编译安装也显得过于繁琐。

一、什么是 FastCGI、PHP-FPM、FastCGI ？

CGI是一种口；FastCGI 是 CGI 的扩展，让 CGI 更高效；PHP-FPM 是一个 PHP FastCGI 管理器；同理 Spawn-FCGI 是一个通用的 FastCGI 管理器，它是 lighttpd 中的一部份。

因此，以 FastCGI 模式运行 php 5.3.4，主要有两种方式，一是 PHP-FPM、二是 Spawn-FCGI ，本文要讲的是以 PHP-FPM 方式运行管理 php。

参考资料：

1、《php-fpm文档中文翻译》 2、《什么是CGI、FastCGI、PHP-CGI、PHP-FPM、Spawn-FCGI？》

二、准备工作

系统环境：Ubuntu-10.10-Server-I386 OpenSSL 版本：openssl-1.0.0c OpenSSH 版本：openssh-5.6p1 MySQL 5 版本：mysql-5.1.53-linux-i686-glibc23

三、编译安装 php5-gd

3.1、安装基础编译环境

apt-get install build-essential -y

3.2、安装 libpng、 libjpeg、 libfreetype

apt-get install libpng12-dev libjpeg62-dev libfreetype6-dev -y

3.3、源码编译安装 Libiconv

wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.13.1.tar.gz
tar -zxf libiconv-1.13.1.tar.gz 
cd libiconv-1.13.1/
./configure --prefix=/usr/local
make && make install

3.4、源码编译安装 gd-2.0.35

wget http://www.libgd.org/releases/gd-2.0.35.tar.gz
tar -zxf gd-2.0.35.tar.gz
cd gd-2.0.35/
./configure --prefix=/usr/local --with-libiconv-prefix=/usr/local --with-png --with-freetype --with-jpeg
make && make install

四、编译安装 php5 扩展库

4.1、libxml、libmhash、libmcrypt、mcrypt、libldap、libsasl

apt-get install libxml2-dev libmhash-dev libmcrypt-dev mcrypt libldap2-dev libsasl2-dev libssh2-1-dev

4.2、编译安装 curl-7.21.3

wget http://curl.haxx.se/download/curl-7.21.3.tar.gz
tar -zxf curl-7.21.3.tar.gz
cd curl-7.21.3/
./configure --prefix=/usr/local
make && make install

五、编译安装 php5.3.4 (FastCGI)

wget http://cn.php.net/distributions/php-5.3.4.tar.gz
tar -zxf php-5.3.4.tar.gz
cd php-5.3.4/ ./configure --prefix=/usr/local/php --with-mysql=/usr/local/mysql --with-mysqli=/usr/local/mysql/bin/mysql_config --with-openssl=/usr --with-png-dir --with-jpeg-dir --with-freetype-dir --with-iconv-dir=/usr/local --with-gd=/usr/local --enable-gd-native-ttf --with-libxml-dir --with-zlib --with-mhash --with-mcrypt --with-ldap --with-ldap-sasl --with-curl=/usr/local --with-curlwrappers --enable-bcmath --enable-calendar --enable-mbstring --enable-ftp --enable-zip --enable-sockets --enable-exif --enable-zend-multibyte --enable-fpm --with-fpm-user=www-data --with-fpm-group=www-data make && make install
cp php.ini-production /usr/local/php/lib/php.ini

–prefix #指定php5安装目录–with-mysql #指定mysql安装目录–with-mysqli #添加mysqli扩展支持–with-openssl #指定openssl安装目录–with-png-dir #GD所需的png库–with-jpeg-dir #GD所需的jpeg库–with-freetype-dir #指定freetype字体库–with-iconv-dir #指定iconv函数库，用于字符集转换–with-gd #指定GD库目录–enable-gd-native-ttf #添加TrueType字符串函数库–with-libxml-dir #指定libxml2库目录–with-zlib #压缩库目录–with-mhash #指定哈希函数库目录–with-mcrypt #指定mcrypt加密函数库–with-ldap #指定ldap库–with-curl #指定cURL库–with-curlwrappers #运用curl工具打开url流–enable-bcmath #高精度数学函数支持–enable-calendar #开启对日历的支持–enable-mbstring #多字节、字符串支持–enable-ftp #开启对ftp的支持–enable-zip #开启对zip的支持–enable-sockets #开启sockets支持–enable-exif #图片元数据支持–enable-zend-multibyte #zend多字节的支持–enable-fpm #开启FastCGI的进程管理支持–with-fpm-user #运行fpm的用户–with-fpm-user #运行fpm的组

六、配置 php-fpm

cp /usr/local/php/etc/php-fpm.conf.default /usr/local/php/etc/php-fpm.conf
vim /usr/local/php/etc/php-fpm.conf

查找下面语句，并将前面"#“号去掉。

pid = run/php-fpm.pid
error_log = log/php-fpm.log
log_level = notice
pm.start_servers
pm.min_spare_servers
pm.max_spare_servers

6.2、开机自动重启 php-fpm

cp sapi/fpm/init.d.php-fpm /etc/init.d/php-fpm
chmod 755 /etc/init.d/php-fpm
update-rc.d php-fpm defaults

Debian/Ubuntu 从源码编译安装 PHP 5

Thu, 13 Jan 2011 00:00:00 +0800

PHP 是一种在服务器端执行的脚本语言，主要用来制作动态网页以提供浏览器读取，但也可以用来开发命令行脚本程序和用户端的GUI应用程序。PHP 可以在许多的不同种的服务器、操作系统、平台上运行，也可以和许多数据库系统结合。

一、准备工作

系统版本：Ubuntu-10.10-Server-I386

OpenSSL 版本：openssl-1.0.0c （安装方法）

OpenSSH 版本：openssh-5.6p1 （安装方法）

Apache 版本：httpd-2.2.17 （安装方法）

MySQL 5 版本：mysql-5.1.53-linux-i686-glibc23 （安装方法）

二、编译安装 GD

GD不是必须的，如果要安装GD，那么 jpeg 库，png 库，zlib 库则是必须的，其余的选择安装。

2.1、编译安装 Zlib

wget http://zlib.net/zlib-1.2.5.tar.gz
tar -zxf zlib-1.2.5.tar.gz
cd zlib-1.2.5/
./configure --prefix=/usr/local
make && make install

2.2、编译安装 PNG

wget ftp://ftp.simplesystems.org/pub/libpng/png/src/libpng-1.4.4.tar.gz
tar -zxf libpng-1.4.4.tar.gz
cd libpng-1.4.4/
./configure --prefix=/usr/local
make && make install

2.3、编译安装 JPEG

wget http://www.ijg.org/files/jpegsrc.v8b.tar.gz
tar -zxf jpegsrc.v8b.tar.gz
cd jpeg-8b/
./configure --prefix=/usr/local
make && make install

2.4、编译安装 Libiconv

wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.13.1.tar.gz
tar -zxf libiconv-1.13.1.tar.gz 
cd libiconv-1.13.1/
./configure --prefix=/usr/local
make && make install

2.5、编译安装 FreeType

wget http://nchc.dl.sourceforge.net/project/freetype/freetype2/2.4.3/freetype-2.4.3.tar.bz2
tar -jxf freetype-2.4.3.tar.bz2 
cd freetype-2.4.3/
./configure --prefix=/usr/local
make && make install

2.6、编译安装 GD

wget http://www.libgd.org/releases/gd-2.0.36RC1.tar.gz
tar -zxf gd-2.0.36RC1.tar.gz
cd gd-2.0.36RC1/
./configure --prefix=/usr/local --with-libiconv-prefix=/usr/local --with-png=/usr/local --with-freetype=/usr/local --with-jpeg=/usr/local
make && make install

三、编译安装 PHP 5

3.1、编译安装 LibXML

wget http://xmlsoft.org/sources/libxml2-2.7.8.tar.gz
tar -zxf libxml2-2.7.8.tar.gz
cd libxml2-2.7.8
./configure --prefix=/usr/local
make && make install

3.2、编译安装 Mhash

wget http://nchc.dl.sourceforge.net/project/mhash/mhash/0.9.9.9/mhash-0.9.9.9.tar.bz2
tar -jxf mhash-0.9.9.9.tar.bz2
cd mhash-0.9.9.9/
./configure --prefix=/usr/local
make && make install

3.3、编译安装 LibMcrypt & Mcrypt

wget http://nchc.dl.sourceforge.net/project/mcrypt/Libmcrypt/2.5.8/libmcrypt-2.5.8.tar.gz
tar -zxf libmcrypt-2.5.8.tar.gz
cd libmcrypt-2.5.8/
./configure --prefix=/usr/local
make && make install

如果要编译安装 Mcrypt，那么必须先安装 Mhash 和 LibMcrypt，否则会报错。

wget http://nchc.dl.sourceforge.net/project/mcrypt/MCrypt/2.6.8/mcrypt-2.6.8.tar.gz
tar -zxf mcrypt-2.6.8.tar.gz
cd mcrypt-2.6.8/
ln -s   /usr/local/bin/libmcrypt-config   /usr/local/bin
LD_LIBRARY_PATH=/usr/local/lib ./configure --prefix=/usr/local
make && make install

编译安装 Mcrypt，配置时切勿遗漏了在环境变量 LD_LIBRARY_PATH 中指明库的搜索路径，或者按一下方法在 /etc/ld.so.conf 动态链接库文件中添加库的搜索路径。（资料1、资料2）。

#编辑，添加共享库路径。
sudo vim /etc/ld.so.conf 
添加一行：/usr/local/lib
sudo ldconfig //更新ld.so.cache

3.4、安装编译 Curl

wget http://www.libssh2.org/download/libssh2-1.2.7.tar.gz
tar -zxf libssh2-1.2.7.tar.gz
cd libssh2-1.2.7/
./configure --prefix=/usr/local
make && make install

wget http://curl.haxx.se/download/curl-7.21.2.tar.gz
tar -zxf curl-7.21.2.tar.gz
cd curl-7.21.2/
./configure --prefix=/usr/local --with-ssl=/usr/local/ssl --with-libssh2=/usr/local
make && make install

3.5、编译安装 php5.3.3

wget http://cn.php.net/distributions/php-5.3.3.tar.gz
tar -zxf php-5.3.3.tar.gz
cd php-5.3.3/
./configure --prefix=/usr/local/php \
--with-apxs2=/usr/local/apache/bin/apxs \
--with-mysql=/usr/local/mysql \
--with-mysqli=/usr/local/mysql/bin/mysql_config \
--with-jpeg-dir=/usr/local \
--with-png-dir=/usr/local \
--with-zlib-dir=/usr/local \
--with-freetype-dir=/usr/local \
--with-iconv-dir=/usr/local \
--enable-gd-native-ttf \
--enable-gd-jis-conv \
--with-gd=/usr/local \
--with-libxml-dir=/usr/local \
--with-mhash=/usr/local \
--with-mcrypt=/usr/local \
--with-openssl=/usr/local \
--with-curl=/usr/local \
--with-curlwrappers \
--enable-bcmath \
--enable-wddx \
--enable-calendar \
--enable-mbstring \
--enable-ftp \
--enable-zip \
--enable-sockets
make && make install

四、将Apache与PHP5相结合

cp php.ini-production /usr/local/php/lib/php.ini
vim /usr/local/apache/conf/httpd.conf

4.1、设置php文件后缀

查找"AddType application/x-gzip .gz .tgz"，在下面添加：

AddType application/x-httpd-php .php

4.2、设置apache的默认文件名次序

查找"index.html"，后面添加“index.php”

index.htm index.html  index.php

4.3、开启Apache Rewrite 模块

查找"Options FileInfo" 将"AllowOverride none" 改为 “AllowOverride all” //

4.4、关闭非必须的Apache模块

因为前期我将所有模块都编译了，所以现在要关闭暂不需要的模块以节省资源。必须开启的模块如下：

LoadModule authz_host_module modules/mod_authz_host.so
LoadModule mime_module modules/mod_mime.so
LoadModule autoindex_module modules/mod_autoindex.so
LoadModule dir_module modules/mod_dir.so
LoadModule alias_module modules/mod_alias.so
LoadModule rewrite_module modules/mod_rewrite.so
LoadModule php5_module        modules/libphp5.so

4.5、编译安装 ZendOptimizer

官方说明最新版的ZendOptimizer-3.3.9只适用于php5.2，不过你用在php5.3倒也不至于出错。

wget http://downloads.zend.com/optimizer/3.3.9/ZendOptimizer-3.3.9-linux-glibc23-i386.tar.gz
tar -zxf ZendOptimizer-3.3.9-linux-glibc23-i386.tar.gz
cd ZendOptimizer-3.3.9-linux-glibc23-i386/data/5_2_x_comp
cp ZendOptimizer.so /usr/local/lib

vim /usr/local/php/lib/php.ini
[ZendOptimizer]
zend_optimizer.optimization_level=15
zend_extension=/usr/local/lib/ZendOptimizer.so

4.6、重启Apache服务器

httpd -k restart

五、添加 php5 扩展

服务器运行一段时间后，可能需求额外添加某个扩展，这就需要在不重新编译PHP的情况下独立添加扩展。下面以Memcache为例说明。

4.1、编译安装Memcache服务器端 (可选）

因为Memcache用到了libevent这个库用于Socket的处理，所以先安装libevent。（Memcache是什么？、Memcache如何安装？）

wget http://www.monkey.org/~provos/libevent-1.4.14b-stable.tar.gz
tar -zxf libevent-1.4.14b-stable.tar.gz
cd libevent-1.4.14b-stable/
./configure --prefix=/usr/local
make && sudo make install

wget http://memcached.googlecode.com/files/memcached-1.4.5.tar.gz
tar -zxf memcached-1.4.5.tar.gz
cd memcached-1.4.5/
./configure --prefix=/usr/local --with-libevent=/usr/local
make && sudo make install

4.2、编译安装Memcache的PHP扩展

添加扩展一般我们只需到php源码ext目录下找即可，但因为php没有自带Memcache扩展，所以你需要另外下载。

wget http://pecl.php.net/get/memcache-3.0.5.tgz
tar -zxf memcache-3.0.5.tgz
cd memcache-3.0.5/
sudo /usr/local/php5/bin/phpize
./configure --enable-memcache --with-php-config=/usr/local/php5/bin/php-config
make && sudo make install

安装完后会看倒下面提示：Installing shared extensions:/usr/local/php5/lib/php/extensions/no-debug-non-zts-20090626/

运行memcached： “/usr/local/bin/memcached”，新建php文件检测是否成功：

<?php
$mem = new Memcache;
$mem->connect("127.0.0.1", 11211);
$mem->set('key', 'This is a test!', 0, 60);
$val = $mem->get('key');
echo $val;
?>

4.3、修改php.ini文件

sudo gvim /usr/local/php/lib/php.ini```
## 将 extension_dir = "./" 改为

extension_dir ="/usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/"
extension=memcache.so

保存退出后，用以下命令检查php配置文件是否正确，然后重启Apache服务器

/usr/local/php5/bin/php -v
sudo httpd -k restart

4.3、编译安装 eaccelerator

eaccelerator安装方法同上面基本一致（详细资料）

wget http://bart.eaccelerator.net/source/0.9.6.1/eaccelerator-0.9.6.1.tar.bz2
tar jxf eaccelerator-0.9.6.1.tar.bz2
cd eaccelerator-0.9.6.1/
sudo /usr/local/php5/bin/phpize
./configure --enable-eaccelerator=shared --with-php-config=/usr/local/php/bin/php-config
make && sudo make install
sudo mkdir /usr/local/cache

修改php.ini文件，在[ZendOptimizer]前面加入下面代码，然后重启apache

[eaccelerator]
extension='/usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/eaccelerator.so'
eaccelerator.shm_size='32'
eaccelerator.cache_dir='/usr/local/cache'
eaccelerator.enable='1'
eaccelerator.optimizer='1'
eaccelerator.check_mtime='1'
eaccelerator.debug='0'
eaccelerator.filter=''
eaccelerator.shm_max='0'
eaccelerator.shm_ttl='3600'
eaccelerator.shm_prune_period='3600'
eaccelerator.shm_only='0'
eaccelerator.compress='1'
eaccelerator.compress_level='9'

五、安装 phpmyadmin

5.1、安装 phpMyAdmin-3.3.8

wget http://nchc.dl.sourceforge.net/project/phpmyadmin/phpMyAdmin/3.3.8.1/phpMyAdmin-3.3.8.1-all-languages.tar.gz
tar -zxf phpMyAdmin-3.3.8.1-all-languages.tar.gz -C /usr/local/apache/htdocs/
mv /usr/local/apache/htdocs/phpMyAdmin-3.3.8.1-all-languages/ /usr/local/apache/htdocs/phpMyAdmin
cd /usr/local/apache/htdocs/phpMyAdmin
cp libraries/config.default.php ./config.inc.php

5.2、激活链接表的附加功能

不想出现“链接表的附加功能尚未激活。要查出原因，请点击此处“这样提示就照做吧。

5.2.1.先建立一个名为phpmyadmin的数据库

/usr/local/mysql/bin/mysql -u root -p 
CREATE DATABASE ```phpmyadmin```;

5.2.2.然后把目录下scripts/create_tables.sql导入到这个库

/usr/local/mysql/bin/mysql -u root -p 
use phpmyadmin
source /usr/local/apache/htdocs/phpMyAdmin/scripts/create_tables.sql

3.编辑config.inc.php配置文件.

vim /usr/local/apache/htdocs/phpMyAdmin/config.inc.php

$cfg['Servers'][$i]['pmadb']           = ''; 
$cfg['Servers'][$i]['bookmarktable']   = ''; 
$cfg['Servers'][$i]['relation']        = ''; 
$cfg['Servers'][$i]['table_info']      = ''; 
$cfg['Servers'][$i]['table_coords']    = '';  
$cfg['Servers'][$i]['pdf_pages']       = ''; 
$cfg['Servers'][$i]['column_info']     = '';  
$cfg['Servers'][$i]['history']         = ''; 
$cfg['Servers'][$i]['tracking']        = '';

将上面语句改成下面的

$cfg['Servers'][$i]['pmadb']           = 'phpmyadmin'; 
$cfg['Servers'][$i]['bookmarktable']   = 'pma_bookmark'; 
$cfg['Servers'][$i]['relation']        = 'pma_relation';
$cfg['Servers'][$i]['table_info']      = 'pma_table_info';
$cfg['Servers'][$i]['table_coords']    = 'pma_table_coords'; 
$cfg['Servers'][$i]['pdf_pages']       = 'pma_pdf_pages'; 
$cfg['Servers'][$i]['column_info']     = 'pma_column_info';
$cfg['Servers'][$i]['history']         = 'pma_history'; 
$cfg['Servers'][$i]['designer_coords'] = 'pma_designer_coords';
$cfg['Servers'][$i]['tracking']        = 'pma_tracking';

5.3、配置文件设置短语密码

同理，不想出现“配置文件现在需要一个短语密码。“这样提示，就照做吧。

编辑config.inc.php配置文件. 修改$cfg[‘blowfish_secret’]的值，其中’abc’为任意值

$cfg['blowfish_secret'] = 'abc';

五、结语

至此，基本的LAMP环境搭建结束了，上述方法同样适用于ubuntu server 和 Debian 。需要说的是目前只是进行了初步的配置，没做任何安全配置，实际部署还请参考其他相关文章。

PHP日期和时间格式

Thu, 06 Jan 2011 00:00:00 +0800

一、年/月/日

1、年

Y（2010）：大写Y表示年四位数字
y（10）：小写y表示年的两位数字

2、月

F（January）：大写F表示月份的英文全写（没有小写f）
M（Jan）：大写M表示月份的3个缩写字符
m（01-12）：小写m表示月份的数字，带前导
n（1-12）：小写n表示月份的数字，无前导

3、日

j（1-31）：小写j表示月份的日期，无前导（没有大写的J）
d（01-31）：小写d表示月份的日期，有前导（没有大写D）
S（st、nd、rd、th）：大写S表示日期的后缀，具体看日期数字为何

4、实例

Y-m-j（2007-02-6 ）
y-n-j（07-2-6）
Y-M-j（2007-Feb-6）
Y-m-d（2007-02-06）
Y-F-jS（2007-February-6th）

二、时:分:秒

1、时

g（1-12）：小写g表示12小时制的小时数，无前导0
h（01-12）：小写h表示12小时制的小时数，有前导0
G（0-23）：大写G表示24小时制的小时数，无前导0
H（01-23）：大写的H表示24小时制的小时数，有前导0
a 表示小写的"am"和"pm"（上午、下午）
A 表示大写的"AM"和"PM"

2、分:秒

默认情况下，PHP解释显示的时间为"格林威治标准时间"，与我们本地的时间相差8个小时。

i（1-60）：小写i表示分
s（1-60)：小写s表示秒

3、实例

g:i:s a（5:56:57 am）
h:i:s A（05:56:57 AM）
G:i:s（14:02:26）

三、闰年、星期、天

大写L表示判断今年是否闰年，布尔值，为真返回1，否则为0
小写w表示星期几，数字形式表示
大写W表示一年中的星期数
小写t表示当前月份有多少天
小写z表示今天是本年中第几天

四、其他

大写T表示服务器的时间区域设置，如值为UTC
大写I表示判断当前是否为夏令时，为真返回1，否则为0
大写U表示从1970年1月1日到现在的总秒数，就是Unix时间纪元的UNIX时间戳。
小写c表示ISO8601日期，日期格式为YYYY-MM-DD，用字母T来间隔日期和时间，时间格式为HH:MM:SS，时区使用格林威治标准时间(GMT)的偏差来表示，如值为2007-02-06T14:24:43+00:00
小写r表示RFC822日期，如值为Tue, 06 Feb 2007 14:25:52 +0000

Windows 快速搭建PHP运行环境

Thu, 16 Dec 2010 00:00:00 +0800

一、安装前准备

Apache：httpd-2.2.17-win32-x86-openssl-0.9.8o
PHP5：php-5.3.3-Win32-VC6-x86
Mysql：mysql-5.1.52-win32
phpMyAdmin：phpMyAdmin-3.3.8-all-languages
Zend：ZendOptimizer-3.3.3-Windows-i386

二、安装与初步配置Apache2

运行Apache，一路“下一步“我的路径是"D:\webserver\Apache2.2"，端口是"80"，其余的随便填。
在开始菜单或安装目录的"conf"文件夹内，编辑 httpd.conf配置文件，分别查找"DocumentRoot"和"Directory"将其后面地址改为网站根目录，如"D:\webserver\www"
查找"index.html"将其改为"index.html index.php"
保存配置文件，重启Apache服务器（开始菜单或状态栏"Restart “）

三、安装与配置php5

解压至 “D:\webserver\php5” 后，将php5目录下的"php5ts.dll"移动到"C:\windows\system32”。
将"php.ini-dist"改名"php.ini"并移动到"C:\windows" 然后做如下修改：
查找 extension_dir = “./”　改为PHP5的ext文件夹地址如"D:\webserver\php5\ext"
将extension=php_gd2.dll、extension=php_mbstring.dll、extension=php_mcrypt.dll、extension=php_mysql.dll前的"；“号去掉。

四、将Apache与PHP5相结合

查找”#LoadModule ssl_module modules/mod_ssl.so"在后面加入"LoadModule php5_module D:\webserver\php5\php5apache2_2.dll"
查找"AddType application/x-gzip .gz .tgz"在后面加入"AddType application/x-httpd-php .php"

五、开启Apache 到rewrite 模块

查找#LoadModule rewrite_module modules/mod_rewrite.so 去掉#号
查找"Options FileInfo AuthConfig Limit" 将其下面的"AllowOverride none" 改为 “AllowOverride all”
查找"Include conf/extra/httpd-autoindex.conf" 去掉前面的"#"

六. 安装MySQL

一路"下一步"填好密码即可，其余的默认。另外，建议安装5.X版本，可以避免在phpMyAdmin中提示PHP版本过低的警告。

七. 安装phpMyAdmin

将phpMyAdmin解压到网站根目录，如"D:\webserver\www" 后，复制文件libraries/ config.default.php到phpMyAdmin 根目录，并改名为"config.inc.php"
查找 $cfg[‘blowfish_secret’] = ‘'; 改为 $cfg[‘blowfish_secret’] = ’ localhost’;

八、安装ZendOptimize

一路"下一步"和"确认"注意要选择正确apche2.2到路径和php.ini路径就行了。

九、修改附件上传大小限制（可选）

编辑php.ini 查找post_max_size =10 M 表单提交最大数据为10M.此项不是限制上传单个文件的大小,而是针对整个表单的提交数据进行限制的. 限制范围包括表单提交的所有内容.例如:发表贴子时,贴子标题,内容,附件等…
file_uploads = On 是否允许上传文件,如果为OFF您将不能上传文件.
upload_tmp_dir = “C:\Inetpub\PHP5\temp” 上传文件时系统使用的缓存目录.如果此目录所在磁盘空间不足的话您将不能上传文件
upload_max_filesize =2 M 最大上传文件大小,此项针对上传文件时单个文件的大小。与post_max_size之间的关系: 在论坛发表贴子时,您post_max_size 设为10M,而此项设成了2M,那么您只能上传最大为2M的附件,且可以同时上传5个。

十.重启Apache即可

到此为止，安装配置就结束了，你成功了吗？看不明白的话，下载附件看详细图文教程。

Php on 七三的小站

PHP 8 从源码安装与配置

目录

1. 一、安装依赖

1.1. 安装编译工具及依赖

1.2. 安装 libiconv

1.3. 安装 libzip（已过时，选做）

1.3.1. 通过 RPM 安装

1.3.2. 手动编译安装

1.4. 安装 imap（已过时，选做）

1.5. 其他 （已过时，选做）

2. 二、安装 PHP

2.1. 下载软件包

2.2. 新增用户和组 (选做)

2.3. 编译安装

3. 三、php 配置

3.1. php-fpm.conf 设置

3.2. www.conf 设置

3.3. php.ini 设置

3.4. 开机自启动

3.5. 配置环境变量

4. 四、安装 PHP 扩展

4.1. PHPRedis

4.2. ImageMagick

4.3. php.ini添 加扩展

5. 五、安装 Composer

Laravel 5 开发知乎笔记

目录

第一章 基础设置

1.1 开发环境

1.2 配置国内软件源

1.3 创建 Laravel 项目

1.4 更改 User 模型位置

1.5 数据库 User 表设计

第二章 用户注册后发送验证邮件

2.1 阿里云邮件推送服务

2.2 发送注册验证邮件

2.3 Sendcloud 邮件服务

第三章 用户注册与登录消息提示

3.1 引入 laracasts/flash 包

3.2 设置帐号未激活不能登录

第四章 视图文件汉化、增加中文语言包

4.1 简体中文语言包

4.2 更新前端资源

第五章 实现找回密码

第六章 设计问题表

第七章 发布问题

7.1 安装 UEditor 编辑器

7.2 发布问题

第八章 问题表单字段验证

8.1 方法一：快速验证

8.2 方法二：表单请求验证

第九章 美化编辑器

9.1 登录后才能发布问题

9.2 自定义 toolbars

第十章 定义话题与问题关系

10.1 Topic 模型

10.2 Question 模型

第十一章 使用 Select2 优化话题选择

11.1 编译压缩 Select2 资源

11.2 多选框（静态）

11.3 多选框（动态）

第十二章 创建和显示话题

12.1 新建话题

12.2 显示问题的所有话题

第十三章 使用 Repository 模式

第十四章 实现编辑问题

14.1 编辑问题

14.2 更新问题

第十五章 问题列表和删除问题

15.1 问题列表

15.2 删除问题

第十六章 创建问题的答案 Answer 模型

第十七章 实现提交回答

17.1 创建 Answer 控制器

17.2 验证 Answer 表单

17.3 视图中显示 Answer

第十八章 用户关注问题

18.1 提交回答需要登录

18.2 关注问题

1.5. 其他（已过时，选做）

4.3. php.ini添加扩展

第一章基础设置

第二章用户注册后发送验证邮件

第三章用户注册与登录消息提示

3.1 引入 `laracasts/flash` 包

第四章视图文件汉化、增加中文语言包

4.1 简体中文语言包

4.2 更新前端资源

第五章实现找回密码

第六章设计问题表

第七章发布问题

第八章问题表单字段验证

第九章美化编辑器

第十章定义话题与问题关系

第十一章使用 Select2 优化话题选择

第十二章创建和显示话题

第十三章使用 Repository 模式

第十四章实现编辑问题

第十五章问题列表和删除问题

第十六章创建问题的答案 Answer 模型

第十七章实现提交回答

第十八章用户关注问题

第十九章用户关注问题（下）

第二十章使用 Vuejs 实现关注问题

第二十一章前后端分离 API token 认证

21.1 在 `users` 表新增 `api_token` 字段

21.2 获取前端生成的 `api_token` 字符串

第二十二章关注用户（上）

第二十三章关注用户（下）

第二十四章站内信通知

第二十五章关注用户之邮件通知

第二十六章重构邮件通知代码

第二十七章对答案进行点赞

第二十八章私信功能（上）

第二十九章私信功能（下）

第三十章实现评论（上）

第三十三章自定义 helper

第三十四章私信列表

第三十五章私信列表（下）

第三十六章回复私信

第三十七章标记私信已读

第三十八章显示未读私信

第三十九章私信实现 Repository 模式

第四十章私信通知

第四十二章上传头像组件

第四十三章头像上传到服务器

第四十四章头像上传到七牛

第四十五章实现修改密码

第四十六章用户个人设置

第四十七章重构用户设置

第1章填充测试数据

第2章初步实现 API 系统

第4章重构 API 代码

第5章处理错误返回

第6章对请求API的用户认证

第7章引入 Dingo API 和 JWT