Laravel

[wxb]

The PHP Framework for Web Artisans

Laravel is a web application framework with expressive, elegant syntax. We’ve already laid the foundation — freeing you to create without sweating the small things.

[wxb]

Laravel内核分析

[wxb]

Laravel-神奇的服务容器

[wxb]

beyondcode/expose

An open-source ngrok alternative - written in PHP.

在网络上通过安全隧道共享本地站点

[wxb]

laravel/sail

Introduction

Sail provides a Docker powered local development experience for Laravel that is compatible with macOS, Windows (WSL2), and Linux. Other than Docker, no software or libraries are required to be installed on your local computer before using Sail. Sail's simple CLI means you can start building your Laravel application without any previous Docker experience.

Inspiration

Laravel Sail is inspired by and derived from Vessel by Chris Fidao. If you're looking for a thorough introduction to Docker, check out Chris' course: Shipping Docker.

Laravel Sail 是一个轻量级的命令行界面，用于与 Laravel 的默认 Docker 开发环境进行交互。Sail 为使用 PHP，MySQL 和 Redis 构建 Laravel 应用程序提供了一个很好的起点，而无需事先具有 Docker 经验。

[wxb]

Laravel Scout 全文搜索

Laravel Scout 为 Eloquent 模型 的全文搜索提供了一个简单的基于驱动程序的解决方案，通过使用模型观察者，Scout 将自动同步 Eloquent 记录的搜索索引。

目前，Scout 附带 Algolia、MeiliSearch 和 MySQL / PostgreSQL (database) 驱动程序。

meilisearch/meilisearch

Website | Roadmap | Blog | Documentation | FAQ | Discord

⚡ A lightning-fast search engine that fits effortlessly into your apps, websites, and workflow 🔍

Meilisearch helps you shape a delightful search experience in a snap, offering features that work out-of-the-box to speed up your workflow.

🔥 Try it! 🔥

一个闪电般的搜索引擎，适合您的应用程序，网站和工作流程毫不费力

[wxb]

mailhog/MailHog

MailHog 会在你本地开发的过程中拦截应用程序发送的电子邮件，并提供一个便捷的 Web 界面，方便你透过浏览器预览电子邮件

Inspired by MailCatcher, easier to install.

• Download and run MailHog
• Configure your outgoing SMTP server
• View your outgoing email in a web UI
• Release it to a real mail server

Built with Go - MailHog runs without installation on multiple platforms.

Overview

MailHog is an email testing tool for developers:

• Configure your application to use MailHog for SMTP delivery
• View messages in the web UI, or retrieve them with the JSON API
• Optionally release messages to real SMTP servers for delivery

[wxb]

laravel/dusk

Introduction

Laravel Dusk provides an expressive, easy-to-use browser automation and testing API. By default, Dusk does not require you to install JDK or Selenium on your machine. Instead, Dusk uses a standalone Chromedriver. However, you are free to utilize any other Selenium driver you wish.

Official Documentation

Documentation for Dusk can be found on the Laravel website.

Laravel Dusk Laravel Dusk 提供了富有表现力、简单易用的浏览器自动化及测试 API

[wxb]

PHP dotenv

Loads environment variables from .env to getenv(), $_ENV and $_SERVER automagically.

Why .env?

You should never store sensitive credentials in your code. Storing
configuration in the environment is one of
the tenets of a twelve-factor app. Anything that
is likely to change between deployment environments – such as database
credentials or credentials for 3rd party services – should be extracted from
the code into environment variables.

Basically, a .env file is an easy way to load custom configuration variables
that your application needs without having to modify .htaccess files or
Apache/nginx virtual hosts. This means you won't have to edit any files outside
the project, and all the environment variables are always set no matter how you
run your project - Apache, Nginx, CLI, and even PHP's built-in webserver. It's
WAY easier than all the other ways you know of to set environment variables,
and you're going to love it!

• NO editing virtual hosts in Apache or Nginx
• NO adding php_value flags to .htaccess files
• EASY portability and sharing of required ENV values
• COMPATIBLE with PHP's built-in web server and CLI runner

PHP dotenv is a PHP version of the original Ruby
dotenv.

---

Laravel 使用了 DotEnv PHP 库

在全新的 Laravel 安装中，应用程序的根目录将包含一个 .env.example 文件，该文件定义了许多常见的环境变量。 在 Laravel 安装过程中，该文件会自动复制到 .env。

.env 文件中的任何变量都可以被外部环境变量覆盖，例如服务器级或系统级环境变量。

[wxb]

Laravel Tinker

Laravel Tinker 是为 Laravel 提供的强大的 REPL（交互式解释器），由 PsySH 提供支持。

[wxb]

Laravel Framework 框架源码

[wxb]

Illuminate\Support\Traits\Macroable 宏

Trait

在 Laravel 中，宏（Macro）是一种在运行时为类添加新方法的方式

• function macro($name, $macro) 注册自定义宏方法
• function mixin($mixin, $replace = true) 将一个类的方法混入到另一个类中

  use Illuminate\Support\Traits\Macroable;
  
  class MyClass
  {
      use Macroable;
  
      public function __construct()
      {
          $this->mixin(new MyMixin());
      }
  }
  
  class MyMixin
  {
      public function myMethod()
      {
          return 'Hello, World!';
      }
  }
  
  $myClass = new MyClass();
  echo $myClass->myMethod(); // 输出 "Hello, World!"

• 支持__callStatic静态调用和__call实例调用

[wxb]

辅助函数 tap

签名

    function tap($value, $callback = null)
    {
        if (is_null($callback)) {
            return new HigherOrderTapProxy($value);
        }

        $callback($value);

        return $value;
    }

可以看到tap函数返回分二种情况：

1. 闭包入参callback是null时，返回(HigherOrderTapProxy)[https://github.com/laravel/framework/blob/10.x/src/Illuminate/Support/HigherOrderTapProxy.php]代理实例；
2. 闭包入参callback非null时，将value应用于闭包函数后返回value值；

函数用法

1. 闭包

  $user = tap(User::first(), function (User $user) {
      $user->name = 'taylor';
   
      $user->save();
  });

2. 强制转换

$user = tap($user)->update([
    'name' => $name,
    'email' => $email,
]);

这里tap后调用update返回依然是user对象的原因是：tap内部的HigherOrderTapProxy代理

public function __call($method, $parameters)
    {
        $this->target->{$method}(...$parameters);

        return $this->target;
    }

Trait

Illuminate\Support\Traits\Tappable
通过向目标类中引入该Trait就可以用调用对象方法的新式使用

return $user->tap(function (User $user) {
    // ...
});