Laravel on Yison's Blog

微信消息编辑器 - Laravel Admin扩展

Sat, 07 Dec 2019 00:00:00 +0000

本文介绍 wxmsg，一个 Laravel Admin 的扩展工具。可视化地编辑待回复的微信消息，最终输出 JSON 格式。

简介

这是一个基于 laravel-admin 后台框架开发的扩展，可在 Form 表单中进行可视化编辑微信消息。

功能特点：

支持多种消息类型（文本、图片、图文、链接、小程序卡片）
消息类型切换自动更新编辑界面
支持多公众号关联
输出标准微信客服消息 JSON 格式

截图

可访问 GitHub 仓库查看完整截图

安装

使用 Composer 安装

composer require yisonli/wxmsg

发布资源

php artisan vendor:publish --tag=wxmsg-assets

基础用法

<?php

namespace App\\Admin\\Controllers;

use Encore\\Admin\\Controllers\\AdminController;
use App\\Models\\WechatReply;

class WechatReplyController extends AdminController
{
 protected function grid()
 {
 $grid = new Grid(new WechatReply());
 
 $grid->id('ID');
 $grid->app_id('公众号');
 $grid->msgtype('消息类型');
 $grid->content('回复内容');
 $grid->created_at('创建时间');
 $grid->updated_at('更新时间');
 
 return $grid;
 }
 
 protected function form()
 {
 $form = new Form(new WechatReply());
 
 // 选择公众号
 $form->select('app_id', '公众号')
 ->options(WechatApp::pluck('name', 'id'))
 ->rules('required');
 
 // 消息类型
 $form->select('msgtype', '回复消息类型')
 ->options([
 'text' => '文本',
 'image' => '图片',
 'news' => '图文',
 'link' => '链接',
 'miniprogrampage' => '小程序卡片',
 ])
 ->rules('required');
 
 // 微信消息编辑器
 $form->wxmsg('content', '回复内容');
 
 return $form;
 }
}

高级用法

关联消息类型

当消息类型字段使用自定义定义方式时，可用 relateTo 函数进行关联：

$form->select('app_id', '公众号')
 ->options($app_list)
 ->rules('required');

$form->select('msgtype', '回复消息类型')
 ->options([
 'text' => '文本',
 'image' => '图片',
 'news' => '图文',
 'link' => '链接',
 'miniprogrampage' => '小程序卡片',
 ])
 ->rules('required');

$form->wxmsg('content', '回复内容')
 ->relateTo('msgtype', 'app_id');

关联多公众号

支持多公众号场景，通过 selectMedia 函数选择素材：

$form->select('app_id', '公众号')
 ->options($app_list)
 ->rules('required');

$form->select('msgtype', '回复消息类型')
 ->options([...])
 ->rules('required');

$form->wxmsg('content', '回复内容')
 ->relateTo('msgtype', 'app_id')
 ->selectMedia('/wechat/reply/medias');

实现素材查询 API

在控制器中添加 API 方法：

<?php

namespace App\\Http\\Controllers\\Admin;

use Illuminate\\Http\\Request;
use App\\Models\\WechatMedia;

class ReplyController extends Controller
{
 /**
 * 查询素材列表
 */
 public function medias(Request $request)
 {
 $app_id = $request->get('a');
 $name = $request->get('q');
 $type = $request->get('t');
 
 $query = WechatMedia::query();
 
 if ($app_id) {
 $query->where('app_id', $app_id);
 }
 
 if ($type) {
 $query->where('type', $type);
 }
 
 if ($name) {
 $query->where('name', 'like', "%{$name}%");
 }
 
 $result = $query->paginate(20, ['media_id', 'name', 'url']);
 
 $data = $result->map(function ($item) {
 return [
 'id' => $item->media_id,
 'text' => sprintf(
 '<img style="max-width:40px;max-height:40px;" src="%s" /> %s',
 $item->url,
 $item->name
 ),
 ];
 });
 
 return response()->json($data);
 }
}

添加路由：

// routes/admin.php
$router->get('/wechat/reply/medias', 'Wechat\\ReplyController@medias');

支持的消息类型

类型	说明	JSON 格式
text	文本消息	`{"msgtype":"text","text":{"content":"..."}}`
image	图片消息	`{"msgtype":"image","image":{"media_id":"..."}}`
news	图文消息	`{"msgtype":"news","news":{"articles":[...]}}`
link	链接消息	`{"msgtype":"link","link":{"title":"...","description":"...","url":"...","thumb_url":"..."}}`
miniprogrampage	小程序卡片	`{"msgtype":"miniprogrampage","miniprogrampage":{"title":"...","appid":"...","pagepath":"...","thumb_media_id":"..."}}`

生成的 JSON 示例

文本消息

{
 "msgtype": "text",
 "text": {
 "content": "欢迎关注我们的公众号！"
 }
}

图片消息

{
 "msgtype": "image",
 "image": {
 "media_id": "MEDIA_ID"
 }
}

图文消息

{
 "msgtype": "news",
 "news": {
 "articles": [
 {
 "title": "文章标题",
 "description": "文章描述",
 "url": "https://example.com/article",
 "picurl": "https://example.com/image.jpg"
 }
 ]
 }
}

数据库表结构

CREATE TABLE `wechat_replies` (
 `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
 `app_id` bigint(20) unsigned NOT NULL COMMENT '公众号ID',
 `msgtype` varchar(20) NOT NULL COMMENT '消息类型',
 `content` text NOT NULL COMMENT '消息内容(JSON)',
 `created_at` timestamp NULL DEFAULT NULL,
 `updated_at` timestamp NULL DEFAULT NULL,
 PRIMARY KEY (`id`),
 KEY `idx_app_id` (`app_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

待开发功能

支持更多消息类型（video、music、msgmenu 等）
美化操作界面
提供实时效果预览
支持消息模板

参考链接

Laravel框架下的PHP辅助函数

Fri, 22 Mar 2019 00:00:00 +0000

Laravel 框架自带了一系列 PHP 辅助函数，很多被框架自身使用。了解这些函数方便我们在代码中善用它们。

数组函数

array_add()

添加给定键值对到数组（如果给定键不存在）：

// 如果键不存在则添加
$array = array_add(['name' => 'Desk'], 'price', 100);
// ['name' => 'Desk', 'price' => 100]

// 如果键已存在则不添加
$array = array_add(['name' => 'Desk', 'price' => 50], 'price', 100);
// ['name' => 'Desk', 'price' => 50] 价格保持 50

array_collapse()

将多个数组合并成一个：

$array = array_collapse([[1, 2, 3], [4, 5, 6], [7, 8, 9]]);
// [1, 2, 3, 4, 5, 6, 7, 8, 9]

// 实际应用：分组数据合并
$postsByCategory = [
 'tech' => [['title' => 'Post 1'], ['title' => 'Post 2']],
 'life' => [['title' => 'Post 3']],
];
$allPosts = array_collapse($postsByCategory);
// [['title' => 'Post 1'], ['title' => 'Post 2'], ['title' => 'Post 3']]

array_divide()

分离数组的键和值：

[$keys, $values] = array_divide(['name' => 'Desk', 'price' => 100]);
// $keys = ['name', 'price']
// $values = ['Desk', 100]

array_dot()

将多维数组转为一维（使用点号分隔键）：

$array = [
 'products' => [
 'desk' => [
 'price' => 100,
 ],
 ],
];

$flattened = array_dot($array);
// [
// 'products.desk.price' => 100,
// ]

array_except() / array_only()

// 排除指定键
$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10];
$except = array_except($array, ['price']);
// ['name' => 'Desk', 'orders' => 10]

// 只保留指定键
$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10];
$only = array_only($array, ['name', 'price']);
// ['name' => 'Desk', 'price' => 100]

array_first() / array_last()

$array = [100, 200, 300];

// 返回第一个匹配的元素
$first = array_first($array, function ($value) {
 return $value >= 150;
});
// 200

// 返回最后一个匹配的元素
$last = array_last($array, function ($value) {
 return $value >= 150;
});
// 300

// 支持默认值
$first = array_first($array, function ($value) {
 return $value >= 500;
}, 'default');
// 'default'

array_flatten()

多维数组转一维：

$array = [['id' => 1], ['id' => 2], [['id' => 3]]];
$flattened = array_flatten($array);
// [1, 2, 3]

array_forget()

使用点号语法删除数组元素：

$array = ['products' => ['desk' => ['price' => 100]]];
array_forget($array, 'products.desk.price');

// $array = ['products' => ['desk' => []]]

array_get()

使用点号语法获取数组值：

$array = [
 'products' => [
 'desk' => ['price' => 100],
 ],
];

$price = array_get($array, 'products.desk.price');
// 100

// 支持默认值
$price = array_get($array, 'products.chair.price', 200);
// 200

array_has()

检查数组是否有指定键：

$array = ['products' => ['desk' => ['price' => 100]]];

array_has($array, 'products.desk');
// true

array_has($array, 'products.chair');
// false

// 支持检查多个键
array_has($array, ['products.desk', 'products.chair']);
// false

array_pluck()

提取数组中指定键的值：

$array = [
 ['product' => 'Desk', 'price' => 100],
 ['product' => 'Chair', 'price' => 50],
];

$products = array_pluck($array, 'product');
// ['Desk', 'Chair']

// 带键
$products = array_pluck($array, 'product', 'price');
// [100 => 'Desk', 50 => 'Chair']

array_pull()

弹出数组元素并删除：

$array = ['name' => 'Desk', 'price' => 100];

$name = array_pull($array, 'name');
// $name = 'Desk'
// $array = ['price' => 100]

array_set()

使用点号语法设置数组值：

$array = [];
array_set($array, 'products.desk.price', 100);

// $array = ['products' => ['desk' => ['price' => 100]]]

array_sort()

按值排序：

$array = [
 ['name' => 'Desk', 'price' => 100],
 ['name' => 'Chair', 'price' => 50],
 ['name' => 'Table', 'price' => 75],
];

$sorted = array_values(array_sort($array, function ($item) {
 return $item['price'];
}));
// [
// ['name' => 'Chair', 'price' => 50],
// ['name' => 'Table', 'price' => 75],
// ['name' => 'Desk', 'price' => 100],
// ]

array_where()

条件过滤数组：

$array = [100, 200, 300, 400, 500];

$filtered = array_where($array, function ($value, $key) {
 return $value >= 200;
});
// [1 => 200, 2 => 300, 3 => 400, 4 => 500]

head() / last()

$array = [100, 200, 300];

head($array); // 100 - 返回第一个元素
last($array); // 300 - 返回最后一个元素

字符串函数

str_contains()

检查字符串是否包含指定内容：

str_contains('Hello World', 'World');
// true

str_contains('Hello World', ['World', 'PHP']);
// true

str_contains('Hello World', ['World', 'PHP']);
// true - 任一匹配即返回 true

str_start()

确保字符串以指定内容开头：

str_start('World', 'Hello ');
// 'Hello World'

str_start('Hello World', 'Hello ');
// 'Hello World' - 已经是则不变

str_finish()

确保字符串以指定内容结尾：

str_finish('Hello', ' World');
// 'Hello World'

str_finish('Hello World', ' World');
// 'Hello World' - 已经是则不变

str_limit()

截断字符串：

str_limit('The quick brown fox jumps over the lazy dog', 20);
// 'The quick brown fox...'

str_limit('The quick brown fox', 20, ' (...)');
// 'The quick brown (...)'

str_plural() / str_singular()

单复数转换：

str_plural('child');
// 'children'

str_plural('child', 1);
// 'child'

str_plural('children');
// 'children'

str_singular('children');
// 'child'

str_slug()

生成 URL 友好的字符串：

str_slug('Hello World');
// 'hello-world'

str_slug('Hello World!', '_');
// 'hello_world'

str_slug('日本語');
// 'ri-ben-yu'

str_replace_array()

批量替换字符串：

$string = 'The framework has :count widgets';

str_replace_array(':count', [5], $string);
// 'The framework has 5 widgets'

str_replace_first() / str_replace_last()

str_replace_first('the', 'a', 'the quick the fox');
// 'a quick the fox'

str_replace_last('the', 'a', 'the quick the fox');
// 'the quick a fox'

// 对应门面（文件顶部需：use Illuminate\Support\Str;）
// Str::replaceLast('world', 'PHP', 'Hello world'); // Hello PHP

str_replace_* 系列常用于日志脱敏、路径规范化等场景；新版本 Laravel 亦可使用 Illuminate\Support\Str 门面，请以当前版本文档为准。

使用Composer安装Laravel/Lumen

Fri, 08 Dec 2017 00:00:00 +0000

本文介绍如何搭建 PHP 的 Laravel 和 Lumen 环境

安装 Composer

方法一：官方安装脚本

php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"

# 移动到系统 PATH
sudo mv composer.phar /usr/local/bin/composer

方法二：直接下载（推荐）

# Linux/macOS
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer

# Windows
# 下载 https://getcomposer.org/Composer-Setup.exe

设置权限

# 添加执行权限
sudo chmod +x /usr/local/bin/composer

修改 Composer 镜像

由于国内网络原因，建议使用国内镜像加速：

# 阿里云镜像（推荐）
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

# Laravel China 镜像
composer config -g repo.packagist composer https://packagist.laravel-china.org

# 恢复官方源
composer config -g --unset repos.packagist

安装 Laravel/Lumen

全局安装 Laravel

composer global require "laravel/installer"

全局安装 Lumen

composer global require "laravel/lumen-installer"

添加到系统 PATH

# 编辑 ~/.bashrc 或 ~/.zshrc
echo 'export PATH="$PATH:$HOME/.composer/vendor/bin"' >> ~/.bashrc
source ~/.bashrc

# 确认目录（可能因 Composer 版本而异）
echo 'export PATH="$PATH:/home/yison/.config/composer/vendor/bin"' >> ~/.bashrc
source ~/.bashrc

验证安装：

composer --version
laravel --version
lumen --version

创建项目

使用 Laravel 创建项目

# 方式一：使用 laravel 命令
laravel new blog

# 方式二：使用 Composer
composer create-project --prefer-dist laravel/laravel blog

# 指定版本
composer create-project --prefer-dist laravel/laravel blog "10.*"

使用 Lumen 创建项目

# 方式一：使用 lumen 命令
lumen new lumen

# 方式二：使用 Composer（推荐）
composer create-project --prefer-dist laravel/lumen lumen

# 指定版本
composer create-project --prefer-dist laravel/lumen lumen "10.*"

启动 Laravel 项目

cd blog

# 安装依赖
composer install

# 复制环境配置
cp .env.example .env

# 生成应用密钥
php artisan key:generate

# 启动开发服务器
php artisan serve
# 访问 http://localhost:8000

启动 Lumen 项目

cd lumen

# 安装依赖
composer install

# 复制环境配置
cp .env.example .env

# 生成应用密钥
php artisan key:generate

# 启动开发服务器
php -S localhost:8000 -t public
# 访问 http://localhost:8000

Laravel/Lumen 常用命令

Artisan 命令

# 查看所有命令
php artisan list

# 创建控制器
php artisan make:controller UserController

# 创建模型
php artisan make:model User

# 创建中间件
php artisan make:middleware AuthMiddleware

# 创建数据库迁移
php artisan make:migration create_users_table

# 执行数据库迁移
php artisan migrate

# 路由列表
php artisan route:list

# 清除缓存
php artisan config:clear
php artisan cache:clear
php artisan view:clear

Composer 常用命令

# 更新依赖
composer update

# 添加依赖
composer require package/name

# 添加开发依赖
composer require --dev phpunit/phpunit

# 移除依赖
composer remove package/name

# 优化自动加载
composer dump-autoload -o

# 查看可用更新
composer outdated

Lumen vs Laravel

特性	Lumen	Laravel
定位	微服务/API	全栈应用
体积	~1MB	~10MB
视图	❌ 不支持	✅ 支持
Session	❌	✅
路由	FastRoute	Symfony Router
开箱即用	较少	丰富
性能	更快	较慢

Docker 部署 Laravel

# 使用 Laravel Sail 快速搭建开发环境
composer require laravel/sail --dev
php artisan sail:install
php artisan db:seed
docker-compose up -d

常见问题

Q: composer 命令找不到

A: 确保 Composer 在 PATH 中：

export PATH="$PATH:$HOME/.composer/vendor/bin"
source ~/.bashrc

Q: 依赖安装失败

A: 尝试清除缓存或更换镜像：

composer clear-cache
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
composer install

Q: 权限不足

A: Linux 系统设置目录权限：

sudo chown -R $USER:$USER /path/to/project
chmod -R 755 /path/to/project
chmod -R 775 /path/to/project/storage