micropackage/filesystem

WordPress 文件系统的包装器,便于文件操作。

1.1.5 2023-06-23 08:33 UTC

This package is auto-updated.

Last update: 2024-09-23 11:24:42 UTC


README

BracketSpace Micropackage Latest Stable Version PHP from Packagist Total Downloads License

Micropackage logo

🧬 关于文件系统

这个微封装是对 WordPress 文件系统的包装,旨在在 wp-content 目录中使用。

支持

  • 插件
  • 必用插件
  • 主题
  • 自定义上传目录
  • 自定义 wp-content 目录

此包将为所有相对路径添加前缀,以提供方便的文件操作方式。

💾 安装

composer require micropackage/filesystem

🕹 使用

从主插件/主题文件初始化 Filesystem 类。它只需要一个基本目录。

use Micropackage\Filesystem\Filesystem;

$filesystem = new Filesystem( __DIR__ );

使用微封装获取完整路径(插件示例)。

echo $filesystem->path();
// /var/www/html/wp-content/plugins/my-plugin/

echo $filesystem->path( 'src/templates/full-width.php' );
// /var/www/html/wp-content/plugins/my-plugin/src/templates/full-width.php

使用微封装获取完整 URL(插件示例)。

echo $filesystem->url();
// https://my.plugin/wp-content/plugins/my-plugin/

echo $filesystem->url( 'assets/images/logo.svg' );
// https://my.plugin/wp-content/plugins/my-plugin/assets/images/logo.svg

将图像文件转换为 base64 URL。

printf( '<img src="%s">', $filesystem->image_to_base64( 'assets/images/logo.svg' ) );
// <img src="data:image/svg+xml;base64,m8q76v7wy4guiev...">

此外,您还可以使用 WP_Filesystem 类提供的任何方法,包括

  • get_contents()
  • exists()
  • is_file()is_dir()
  • mkdir()
  • delete()
  • ...

查看所有可用方法

📦 关于微封装项目

微封装 - 如其名所示 - 是带有少量可重用代码的微包,特别有助于 WordPress 开发。

目标是拥有多个包,可以通过定义结构来组合在一起创建更大的东西。

微封装由 BracketSpace 维护。

📖 更新日志

查看更新日志文件.

📃 许可证

本软件根据 MIT 许可证发布。有关更多信息,请参阅 LICENSE 文件。