---
url: https://docs.zblogcn.com/php/dev-start.md
description: Z-BlogPHP 应用开发入门，介绍插件与主题的区别、应用 ID 命名规范、创建应用的方法及开发模式的开启方式。
---

# 开始

本篇介绍 Z-BlogPHP 应用开发的基本概念，包括插件与主题的区别、应用 ID 命名规范、创建应用的方法及开发模式的开启方式。

## 应用概念

### 插件

* 以功能性为主要目的；
* 按照既定规范组织文件和内容；
* 以统一的方式「安装/删除」「启用/关闭」；
* 可按照功能目的使用接口，也可以不用；「[接口列表](/php/dev-interfaces "docs-zblogphp 接口列表")」
* 「自述文件」为 `plugin.xml` ；
* 插件放置目录为 `zb_users/plugin` ；

### 主题

* 用于定制 Z-Blog 前台界面，提供布局效果及样式；
* 按照既定规范组织文件和内容；
* 以统一的方式「安装/删除」「更换]，一般情况下只能使用一款主题；
* 可按需「内置」功能性效果；
* 「自述文件」为 `theme.xml` ；
* 主题放置目录为 `zb_users/theme` ；

## 通用规范

* 「应用目录名」应与「应用 ID」相同，系统也以此作为识别；（注 1）
* 对于 ID 命名的主体，全小写，首字母大写，驼峰式均可；
* 为避免重复及便于识别，可以增加标识前缀，使用 `_` 与主体分隔；（注2）
* 对于「应用目录」下的全部子目录及文件，原则上建议全部小写；

**注 1：「应用目录」及「自述文件」可按下方操作自动生成；**

**注 2：** 应用 ID 在应用中心全局唯一，直接用功能名（如 `botblock`）容易撞车，撞车后无法上架。建议用「品牌/作者标识 + `_` + 功能名」，如 `qing_botblock`、`wdssmq_links`。

## 创建应用

可进入「后台管理」界面，在 `应用中心` 插件中，通过点击 `新建主题` 或 `新建插件` 按钮创建应用；

会自动创建相应的文件夹及「自述文件」，并根据应用类型放入「初始文件」。

## 开发模式

开发主题或插件需要**分别**开启「应用中心插件」和「Z-Blog」的「开发模式」：

* `网站设置` → `全局设置` → `开发模式`
  * 开启后会在程序出错时显示更详细的信息用于排查；
  * 对于线上环境，请勿长期开启此模式；
* `应用中心` → `设置` → `开发模式`
  * 用以修改应用信息（「自述文件」）、导出应用或提交应用到「应用中心」；