Appearance

Laravel 学习笔记 ​

composer 安装 ​

介绍 ​

composer 是一个便于管理php 框架的工具, 因为有很多的教程来介绍这个 composer 所以这里不会介绍

学习资料 ​

安装 ​

下载并且指定安装目录, 并且确定 win 平台的的环境变量中有这个目录, 使用 composer 命令能够直接调用

设置镜像 ​

参考 : Composer 安装和访问加速

安装 Laravel ​

安装 Laravel installer ​

  • 使用 composer 下载运行需要的文件
composer global require "laravel/installer=~1.1"
  • 将 ~/.composer/vendor/bin 放入到环境变量中

使用 new 方法来创建项目 ​

测试的目录为 laravelRun

laravel new laravelRun

这是初始化之后的文件目录结构

结构目录说明

laravel
├ app 代码目录
│ ├─ Http 应用程序的 HTTP 传输层
│ │ ├─ Controllers  控制器: 用于提供基本的逻辑、 数据模型交互以及加载应用程序的视图文件的控制器类
│ │ ├─ Middleware   中间件
│ │ ├─ Controllers  请求
│ │ ├─ Kernel.php
│ │ └─ routes.php   路由文件
├ resources 应用程序的语言文件和视图
│ ├ lang         应用程序易于本地化的字符串的数组, 默认包含英语语言的分页和表单验证的语言行
│ └ views        视图资源模版, 请注意，这个文件夹下你只能放置模版文件
├ config
│ ├ app.php      应用程序级设置，即时区、 区域设置（语言环境）
│ ├ auth.php     身份验证驱动
│ ├ cache.php    如果应用程序利用缓存来加快响应时间，要在此配置该功能
│ ├ compile.php  可以指定一些额外类，去包含由 `artisan optimize` 命令声称的编译文件。这些应该是被包括在基本上每个请求到应用程序中的类
│ ├ database.php 包含数据库的相关配置信息，即默认数据库引擎和连接信息。
│ ├ mail.php     为电子邮件发件引擎的配置文件，即 SMTP 服务器，From:标头
│ ├ session.php  控制Laravel怎样管理用户sessions,即session driver, session lifetime
│ └ view.php     模板系统的杂项配置
├ database
│ ├ migrations   保持所有版本的数据库的同步的迁移文件
│ └ seeds        允许Artisan工具用关系数据来填充数据库表的 PHP 文件
├ tests     该文件夹给你提供了一个方便的位置，用来做单元测试。如果你使用PHPUnit，你可以使用Artisan工具一次执行所有的测试
├ public    web 服务器的绑定目录, 静态资源文件如css, javascript和images文件应该放在这里
└ vendor    用来存放所有的第三方代码，在一个典型的 Laravel 应用程序，这包括 Laravel 源代码及其相关，并含有额外的预包装功能的插件

检测权限(linux) ​

同时检测下 ./storage 有没有权限, 否则可能报错 Error in exception handler .由于 5.0 版本和 4.* 版本的差别. 5.0版本的存储位置被放置在 ./storage 目录下

测试运行 ​

系统需求 ​

  • PHP >= 5.4
  • Mcrypt PHP Extension
  • OpenSSL PHP Extension
  • Mbstring PHP Extension

配置 ​

  • 设置 key , 这里生成的key 放在 .env 文件中, 用于数据的加密 生成key
cd laravelRun
php artisan key:generate
# Application key [1hSm25JlcusKQGdShlbnZlgVaCb3DetR] set successfully.

配置.env 文件

APP_KEY=1hSm25JlcusKQGdShlbnZlgVaCb3DetR
  • 设置 config/app.php 文件

Apache 虚拟主机方式运行 ​

配置Apache我这里是 apache , 这里以 apache 为例, 这里需要配置 apache 对重写的支持 使用 MOD_REWRITE 启用 url rewrite/url重写

<VirtualHost *:80>
  ServerName laravel.example.com
  DocumentRoot "G:/wamp/www/example/laravel/public"
  Options FollowSymLinks Indexes
</VirtualHost>

运行成功

使用artisan 服务器方式运行 ​

php artisan serve
# Laravel development server started on http://localhost:8000

然后运行 http://localhost:8000/ 也会访问到这个位置

使用 nginx 配置 Laravel ​

server {
    listen 80;
    server_name l.start.duoli.com;
    index index.php index.html index.htm default.html default.htm default.php;
    root /data/workbench/www/laravelRun/public;
    client_max_body_size 20m;
    location ~ .*\.(php|php5)?$ {
        fastcgi_pass 127.0.0.1:9000;
          # fastcgi_pass unix:/run/php/php7.0-fpm.sock;
        fastcgi_index index.php;
        include fastcgi.conf;
    }
    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ .*\.(js|css)?$ {
        expires 12h;
    }
    # more_set_headers 'Access-Control-Allow-Origin *';
    # more_set_headers 'Access-Control-Allow-Headers X-Requested-With,X-ACCESS-TOKEN,Content-Type';
    # more_set_headers 'Access-Control-Allow-Methods GET,POST,OPTIONS';
    access_log /data/workbench/logs/wulihub_access.log;
    error_log /data/workbench/logs/wulihub_error.log;
}

事件监听 ​

设置监听事件 ​

在 app/Providers/EventServiceProvider 中设置需要监听的事件

class EventServiceProvider extends ServiceProvider {
    protected $listen = [
        'admin.login_ip_banned' => [
            'App\\Handlers\\Events\\Admin\\LoginIpBannedLog',
        ],
        'admin.login_ok' => [
            'App\\Handlers\\Events\\Admin\\LoginOkLog',
        ],
    ];
    // ...
}

设置处理函数 ​

LoginIpBannedLog

class LoginIpBannedLog {
    // 处理事件的函数
    public function handle($ip, $user) {
        PamLog::create([
            'account_id' => $user->account_id,
            'account_name' => $user->account_name,
            'account_type' => $user->account_type,
            'log_type' => 'error',
            'log_ip'  => $ip,
            'log_content' => 'ip 禁止登陆',
        ]);
    }
}

设置触发条件 ​

在需要触发的时候触发条件, 并用数组传入需要传递的值

\\Event::fire('admin.login_ip_banned', [$this->ip, \\Auth::user()]);

控制器 ​

  • 使用命令行创建 Welcome 控制器
php artisan make:controller FirstController --only=index

运行上述命令后，Laravel 会生成 app/Http/controllers/WelcomeController.php 文件。生成文件后修改其中的 index 方法：

public function index() {
    return view('first.index');;
}
  • 创建视图在 resources/views/ 目录新建文件夹 first 并创建文件 index.blade.php ;在 index.blade.php 文件中添加 <h1>Hello, Laravel!</h1> ;

配置文件 ​

配置 config/app.php ​

timezone 为 RPC 、 locale 为 zh

debug

当应用处于 debug 模式, 出错的时候将详细的错误信息和trace信息, 关闭将显示公共的错误信息

url

应用url. 使用命令行的时候生成url使用, 例如在运行 Artisan 计划任务的时候

timezone

给应用指定默认时区, 这个配置会被 php 的日期函数调用

locale

地区

fallback_locale

回滚地区

key

生成的加密key

cipher

加密方式

log

日志配置

providers

自动加载的服务提供者

数据库配置 config/database.php ​

由于数据库中定义调用了 .env 的方法, 所以这里使用 .env 的方式来加载配置之前的配置, 这里只是修改一个前缀

数据库前缀

'mysql' => [
    // ...
    'prefix'    => 'mk_',
    // ...
],

数据库链接 .env 文件

创建在服务器中创建数据库

DB_HOST=127.0.0.1
DB_DATABASE=mark_laravel
DB_USERNAME=root
DB_PASSWORD=

文件树 ​

框架文件目录树 ​

laravel
├ app 代码目录
│ ├─ Http 应用程序的 HTTP 传输层
│ │ ├─ Controllers  控制器: 用于提供基本的逻辑、 数据模型交互以及加载应用程序的视图文件的控制器类
│ │ ├─ Middleware   中间件
│ │ ├─ Controllers  请求
│ │ ├─ Kernel.php
│ │ └─ routes.php   路由文件
├ resources 应用程序的语言文件和视图
│ ├ lang         应用程序易于本地化的字符串的数组, 默认包含英语语言的分页和表单验证的语言行
│ └ views        视图资源模版, 请注意，这个文件夹下你只能放置模版文件
├ config
│ ├ app.php      应用程序级设置，即时区、 区域设置（语言环境）
│ ├ auth.php     身份验证驱动
│ ├ cache.php    如果应用程序利用缓存来加快响应时间，要在此配置该功能
│ ├ compile.php  可以指定一些额外类，去包含由 `artisan optimize` 命令声称的编译文件。这些应该是被包括在基本上每个请求到应用程序中的类
│ ├ database.php 包含数据库的相关配置信息，即默认数据库引擎和连接信息。
│ ├ mail.php     为电子邮件发件引擎的配置文件，即 SMTP 服务器，From:标头
│ ├ session.php  控制Laravel怎样管理用户sessions,即session driver, session lifetime
│ └ view.php     模板系统的杂项配置
├ database
│ ├ migrations   保持所有版本的数据库的同步的迁移文件
│ └ seeds        允许Artisan工具用关系数据来填充数据库表的 PHP 文件
├ tests     该文件夹给你提供了一个方便的位置，用来做单元测试。如果你使用PHPUnit，你可以使用Artisan工具一次执行所有的测试
├ public    web 服务器的绑定目录, 静态资源文件如css, javascript和images文件应该放在这里
└ vendor    用来存放所有的第三方代码，在一个典型的 Laravel 应用程序，这包括 Laravel 源代码及其相关，并含有额外的预包装功能的插件

框架加载文件树 ​

└ illuminate
  ├contracts   主要组件实现所用的接口

集合 ​

macro 示例 ​

在运行时候动态添加函数

use Illuminate\\Support\\Collection;
Collection::macro('someMethod', function ($arg1 = 1, $arg2 = 1) {
    return $this->count() + $arg1 + $arg2;
});
$coll = new Collection([1, 2, 3]);
echo $coll->someMethod(1, 2);
// 6      = 3 + (1 + 2)
echo $coll->someMethod();
// 5      = 3 + (1 + 1)

事件调度(定时任务) ​

Laravel 5 新增了一个框架内置的 cron 风格的令人难以置信的调度程序（与 Indatus 的 Dispatcher
类似）。只要在服务器上设置一个每分钟调用 artisan schedule:run 的 cron job, 一切就准备就绪了

* * * * * php /path/to/artisan schedule:run

举个例子，通过绑定下面的事件，可以实现每天自动清理密码提示记录：

$schedule
    ->command('auth:clear-reminders') // 清理密码提示
    ->daily() // 每天执行
    ->sendOutputTo($logPath) // 把输出写入日志
    ->emailOutputTo('me@me.com'); // 把输出发到指定邮箱

你可以通过 command() 来调用 artisan 命令, call 来调用方法或函数， 或者 terminal() 来执行单行命令脚本：

$schedule->call('YourClass@someMethod')->twiceDaily();

$schedule->call(function() {
    // Do stuff
})->everyFiveMinutes();

还可以借助回调来决定什么时候执行或不执行某些操作，通过 when() 或者 skip() 实现：

$schedule
    ->call('Mailer@BusinessDayMailer') // 执行类方法
    ->weekdays() // 周一到周五执行
    ->skip(function(TypeHintedDeciderClass $decider) { // 如果是节假日则跳过
        return $decider->isHoliday();
    });

显示自定义控制器数据调用 ​

创建控制器

  • 使用命令行创建 Welcome 控制器
php artisan make:controller FirstController --only=index

运行上述命令后，Laravel 会生成 app/Http/controllers/WelcomeController.php 文件。生成文件后修改其中的 index 方法：

public function index() {
    return view('first.index');;
}

创建视图

在 resources/views/ 目录新建文件夹 first 并创建文件 index.blade.php ;

在 index.blade.php 文件中添加 <h1>Hello, Laravel!</h1> ;

.env 环境变量 ​

PHP dotenv 是这个 env 文件的详细说明

APP_ENV=local
APP_DEBUG=true
APP_KEY=1hSm25JlcusKQGdShlbnZlgVaCb3DetR
DB_HOST=127.0.0.1
DB_DATABASE=mark_laravel
DB_USERNAME=root
DB_PASSWORD=
CACHE_DRIVER=file
SESSION_DRIVER=file

PHP dotenv 介绍 ​

Laravel 5.0 其实也没做什么特别的创新，它只是使用了 PHP dotenv, 一个从单一 .env
文件中加载环境配置的第三方库。

新版本的 Laravel 初始框架包含一个默认的 .env.example 文件，这个文件暂时看起来长这样：

APP_ENV=local
APP_KEY=SomeRandomString
DB_USERNAME=homestead
DB_PASSWORD=homestead

要使用这个功能，只需要复制这个文件并重命名为 .env (类似 wordpress 的 wp-config-sample.php).
为什么不直接重命名原始文件而是先复制再重命名呢？下面马上就要说到了。

接下来，就可以编辑 APP_ENV 的值来指定运行环境了。这是在 Laravel 5.0
中我们指定应用运行环境名称的主要手段。可以看一下 bootstrap/environment.php 里最新的环境监测代码，它非常简单：

$env =  $app->detectEnvironment(function(){
    return getenv('APP_ENV') ?:  'production';
});

这么简单，多美好的一件事！

自定义环境配置文件 ​

现在回答刚才的那个问题：为什么不直接重命名 .env.example 这个原始文件呢？想象一下，假设你的应用要定义 10
个环境变量，怎么确保它被部署到不同运行环境下时都能保证定义了这些环境变量呢？当然，你可以在捡测到环境变量没定义的时候进行容错处理。但更好的处理方式还是定义这些变量。

这种情况下，你打算在那里做每个部署的 .env 文件的变量配置说明呢？一种方式：你可以写在 readme
文件里。更好的办法是更新 .env.example 文件，在里面加上你的应用需要定义的环境变量以及相应的注释。

如此一来，如果在应用的每个部署都定义 10 个环境变量，那就把这 10 个环境变量加到你的 .env.example
文件里，指定默认值。这个默认文件会提交到你的版本管理工具中。然后每次进行部署时只要执行 cp .env.example .env
命令，然后对 .env 中的变量值进行修改即可。

变量引用 ​

如果需要了解更多，可以查看 PHP dotenv 的文档，但我可以告诉你一个最有用的技巧：一个已定义的环境变量是可以在后续的环境变量值中引用的。看一下他们的说明文档中的例子：

BASE_DIR=/var/webroot/project-root
CACHE_DIR=$BASE_DIR/cache
LOG_DIR=$BASE_DIR/logs

很直观。

指定必须定义的变量 ​

某些变量是系统运行不可或缺的。对于这种情况，我们可以指定他们是必须定义的，而不是等应用开始用到这些变量时才发现没有定义而造成崩溃：

Dotenv::required('DB_USERNAME');
// 或者
Dotenv::required(['DB_HOST',  'DB_NAME',  'DB_USERNAME',  'DB_PASSWORD']);

通过 Dotenv::required()
方法指定即可，参数可以是单个字符串或者是字符串数组，每个字符串代表一个环境变量名。如果某个环境变量没有定义，系统会抛出一个 RuntimeException .

如今你可以很轻松地定义自己的运行环境名称和环境变量，而且是在单一的一个文件中，以一种可预期的，始终一致的方式来实现

路由缓存 ​

在 PHP 代码中进行性能优化并非总是我们优先考虑的问题. 但是我们对后端代码的性能优化--特别是在一些很复杂的操作上--可以对网站的请求时间产生几十甚至几百毫秒的影响.看上去不算很多, 但是几百毫秒的差异对于你的应用的用户感知速度来说可能意味着巨大的差异 ( 链接可能需要扶墙访问).

你可能没有注意到, 在 Laravel 4 以及更老版本中, 路由逻辑是性能上的一个瓶颈--特别是对于有很多路由定义的应用而言.

一个只有几百条路由定义的 Laravel 站点, 框架光注册路由就需要半秒多的时间. 不过以后不用担心这个问题了, 因为 Laravel 5 引入了 路由缓存(route caching) , 可以大大优化路由的性能(闭包方式定义的路由不能缓存, 所以该把所有的闭包路由定义都移到控制器中了).

使用路由缓存 ​

老实说, 使用路由缓存很简单. 有一个新的 Artisan 命令 route:cache 可以把 routes.php 文件中的所有路由定义序列化

会对所有的路由进行一次解析然后把解析结果缓存起来. 如果你曾经用过 Handlebars 模板的预编译的话, Laravel 5 的路由缓存机制跟它有点类似.

这样就已经搞定了. 执行完这个命令以后, 所有的路由都是从缓存文件而不是路由文件进行读取. 之后你可以对 routes.php 的随意进行修改,但应用的路由不会发生变化, 一直到再次执行 route:cache 重新缓存.

优点和缺点 ​

优点很明显: 网站的速度会更快.

但缺点也不得不提: 只要缓存过一次网站的路由定义, 以后每次对 routes.php 文件进行修改都需要重新执行缓存操作, 否则修改不会生效.这可能会造成部分开发者的疑惑, 有可能你可能怎么修改 routes.php 都没用, 偏偏一时没想到是路由缓存造成的.

幸亏有两个方法可以解决这个问题.

第一种方法: 可以执行 artisan route:clear , 这样 artisan 会删除路由缓存.

第二种方法: 可以考虑只在正式环境使用路由缓存. 然后在 Git 的 post-deploy 钩子中执行 artisan route:cache , 或者在部署脚本中来执行它.

写在最后 ​

如果觉得路由缓存带来的性能提升还不如造成的潜在混乱和麻烦多, 你可以当这个特性不存在. 但是对于有更好的部署流程管理的团队来说,能够这么简单就能减少每个页面半秒钟以上的加载时间, 这价值就太大了.

参考 ​

这里推荐一篇文章 使用 PhpStorm 开发 Laravel 应用 对于代码提示的强迫症人员和提示人员, 请移步观看下

说明

创建时间: 2023-01-15 00:37:00 , 最后编辑于 2023-12-10 09:30:00