README

WordPress 骨架 组件基于 Pollen Solutions 套件提供 WordPress 项目的结构。

目录

• 特性
• 安装
  • 标准安装
  • Docker 安装
• 配置
  • 环境配置
  • 自定义本地环境配置
  • 环境变量类型
  • 环境变量映射
  • 使用应用程序变量
• 目录结构
  • 根目录结构
  • 根目录详细信息

特性

Pollen solutions 骨架 组件集成了

• Composer，作为 PHP 库的包管理器。
• ViteJS 作为资源打包器，负责编译、转译、版本化、优化等。
• Pollen solutions 组件套件，包括
  • 依赖注入容器
  • 路由系统
  • 模板库
  • 资源管理器和注入器
  • 可扩展的命令行界面
  • 事件管理器
  • ...
• 预配置的 Docker 环境，集成了
  • 轻量级的命令行界面，便于轻松与 Docker 交互
  • 通过 Apache 运行的 PHP 服务器
  • MySQL 服务器
  • 邮件预览服务（MailHog）
  • 共享本地应用程序服务
  • ...
• ... 以及许多其他类型的魔法！

尝试它就是贡献，欢迎您！

安装

标准安装

先决条件

• PHP 必须安装在您的机器上 查看详情。
• Composer 必须安装在您的机器上 查看详情。

启动安装

composer create-project pollen-solutions/wp-skeleton your-app-name

提供服务

从 public 目录使用 PHP 内置的 Web 服务器（或您选择的任何服务器）提供您的应用程序 查看详情。

php -S 127.0.0.1:8000 -t public

在浏览器中访问应用程序

• http://127.0.0.1:8000

Docker 安装

先决条件

• Docker 必须安装在您的机器上 查看详情

启动安装

composer create-project pollen-solutions/wp-skeleton your-app-name --no-install --no-scripts

启动应用程序构建器

cd ./your-app-name

bin/app.build

在浏览器中访问应用程序

• http://127.0.0.1:8000

在 Pollen 应用程序中获取有关 Docker 使用方法的详细信息 查看详情。

配置

环境配置

在安装过程中，文件 .env.example 被复制到 .env。此文件包含所有必需的默认配置。

# ENVIRONMENT
APP_ENV=dev
APP_DEBUG=true
APP_URL=http://127.0.0.1:8000
APP_TIMEZONE=Europe/Paris

# DATABASE
DATABASE_URL=sqlite:///%%app.base_dir%%/var/database.sqlite

自定义本地环境配置

要自定义应用程序配置，您可以直接编辑 .env 文件，但最佳实践是创建一个新的 .env.local 文件，其中将包含所有特定于您安装的配置属性。通过 .env.local 文件，您可以在必要时覆盖在 .env 文件中声明的环境值或定义新的值

# DATABASE
DATABASE_URL=mysql://root:root@mysql:3306/pollen

#REDIS
REDIS_CLIENT=phpredis
REDIS_HOST=127.0.0.1

环境变量类型

STRING_VAR=string
QUOTES_VAR="quoted variable"
EMPTY_STRING=
BOOL_VAR=true
NULL_VAR=null

环境变量映射

您可以使用另一个现有的全局或之前定义的环境变量，如下所示

DB_USERNAME=${MYSQL_USER}
DB_PASSWORD=${MYSQL_PASSWORD}

注意，出于安全原因，全局环境变量无法覆盖。

使用应用程序变量

在某些特殊情况下，您可能需要访问应用程序变量以完成环境变量的配置，合并变量可以帮助您。

应用程序的路径是原生的

• %%app.base_dir%%：应用程序根目录的绝对路径。

• %%app.public_dir%%：应用程序公共目录的绝对路径。

使用示例

DATABASE_URL=sqlite:///%%app.base_dir%%/var/database.sqlite

花粉解决方案套件使用 vlucas/phpdotenv 库进行工作。有关其更多信息，请参阅其 GitHub 仓库。

目录结构

WordPress 骨架 组件是一个用于与 WordPress 内容管理系统（CMS）协同工作的微型框架。与其他此类解决方案一样，它具有自己的观点，并且其目录结构旨在为创建完整的网络应用程序提供一个起点。

根目录结构

|–– bin
|–– bootstrap
|–– config
|–– docker
|–– docs
|–– (node_modules)
|–– public
    |–– (assets)
    |–– languages
    |–– mu-plugins
    |–– plugins
    |–– themes
    |–– uploads
    |–– (wordpress)
|–– resources
    |–– assets
    |–– views
|–– src
|–– tests
|–– var
|–– (vendor)

根目录

src

src 目录包含您应用程序的核心 PHP 代码。

resources

resources 目录包含模板代码。这包括视图、CSS、JS、字体、图像以及所有其他资产文件。

public

public 目录包含 index.php 文件，这是所有进入您应用程序的请求的入口点，并配置了自动加载。

此目录还包含构建资产，如 CSS、JS、字体、图像以及所有其他资产文件。

config

正如其名称所暗示的，config 目录包含您应用程序的所有 PHP 配置文件。

docs

docs 目录包含微型框架及其组件的完整文档。工作进行中 ;)