在 ThinkPHP 5.1 项目中创建一个新的模块

文章目录

  • 前言
    • [📦 ThinkPHP 模块结构](#📦 ThinkPHP 模块结构)
    • [🎯 创建新模块的步骤](#🎯 创建新模块的步骤)
    • [📝 更完整的模块示例](#📝 更完整的模块示例)
      • [1. 创建模型 `d:\php\ht\application\test\model\User.php`](#1. 创建模型 d:\php\ht\application\test\model\User.php)
      • [2. 创建控制器 `d:\php\ht\application\test\controller\User.php`](#2. 创建控制器 d:\php\ht\application\test\controller\User.php)
      • [3. 创建视图文件](#3. 创建视图文件)
    • [🔑 访问路径总结](#🔑 访问路径总结)
    • [⚠️ 注意事项](#⚠️ 注意事项)

前言


📦 ThinkPHP 模块结构

首先看看现有项目的结构:

复制代码
d:\php\ht\application\
├── admin/           ← 后台管理模块
│   ├── controller/   ← 控制器(处理请求)
│   ├── model/       ← 模型(操作数据库)
│   └── view/        ← 视图(显示页面)
│   └── config/      ← 模块配置
│
├── api/             ← API接口模块
│   ├── controller/
│   ├── model/
│   └── view/
│
└── chat/            ← 聊天模块

🎯 创建新模块的步骤

假设我们要创建一个 "Test" 测试模块

步骤1:在 application 目录下创建模块文件夹

在 d:\php\ht\application\ 下创建:

复制代码
test/                    ← 新模块目录
├── controller/          ← 控制器目录
├── model/               ← 模型目录
├── view/                ← 视图目录
│   └── test/            ← 视图子目录(与控制器对应)
│       └── index.html   ← 视图文件
└── config/             ← 模块配置目录

步骤2:创建控制器文件

在 d:\php\ht\application\test\controller\ 下创建 Index.php

php 复制代码
<?php
namespace app\test\controller;

use think\Controller;

class Index extends Controller
{
    // 首页方法
    public function index()
    {
        return $this->fetch();
    }
    
    // 欢迎方法
    public function hello($name = 'World')
    {
        return 'Hello, ' . $name . '!';
    }
}

步骤3:创建视图文件

在 d:\php\ht\application\test\view\test\ 下创建 index.html

html 复制代码
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Test 模块</title>
</head>
<body>
    <h1>欢迎来到 Test 模块!</h1>
    <p>这是我的第一个 ThinkPHP 模块</p>
</body>
</html>

步骤4:访问新模块

创建完成后,访问地址:

复制代码
http://flyenv-test-oqbbixhm.test/test          ← 访问 index 方法
http://flyenv-test-oqbbixhm.test/test/index    ← 同上
http://flyenv-test-oqbbixhm.test/test/hello    ← 访问 hello 方法

📝 更完整的模块示例

让我给你演示一个带完整功能的模块(增删改查):

1. 创建模型 d:\php\ht\application\test\model\User.php

php 复制代码
<?php
namespace app\test\model;

use think\Model;

class User extends Model
{
    // 设置表名(可选,默认会解析)
    protected $name = 'user';
    
    // 自动写入时间戳(可选)
    protected $autoWriteTimestamp = true;
}

2. 创建控制器 d:\php\ht\application\test\controller\User.php

php 复制代码
<?php
namespace app\test\controller;

use think\Controller;
use app\test\model\User as UserModel;

class User extends Controller
{
    // 用户列表页面
    public function lists()
    {
        // 查询所有用户
        $users = UserModel::select();
        
        // 分配给视图
        $this->assign('users', $users);
        
        // 渲染视图
        return $this->fetch();
    }
    
    // 添加用户表单页面
    public function add()
    {
        return $this->fetch();
    }
    
    // 处理添加用户
    public function doAdd()
    {
        // 获取POST数据
        $data = input('post.');
        
        // 创建用户
        $user = new UserModel();
        $user->save($data);
        
        // 返回成功
        return '用户添加成功!';
    }
    
    // 编辑用户
    public function edit($id)
    {
        // 查询用户
        $user = UserModel::find($id);
        
        // 分配给视图
        $this->assign('user', $user);
        
        return $this->fetch();
    }
    
    // 删除用户
    public function doDel($id)
    {
        UserModel::destroy($id);
        
        return '删除成功!';
    }
}

3. 创建视图文件

列表页 d:\php\ht\application\test\view\user\lists.html

html 复制代码
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>用户列表</title>
</head>
<body>
    <h1>用户列表</h1>
    
    <a href="/test/user/add">添加用户</a>
    
    <table border="1">
        <tr>
            <th>ID</th>
            <th>用户名</th>
            <th>操作</th>
        </tr>
        <?php foreach($users as $user): ?>
        <tr>
            <td><?php echo $user['id']; ?></td>
            <td><?php echo $user['username']; ?></td>
            <td>
                <a href="/test/user/edit/id/<?php echo $user['id']; ?>">编辑</a>
                <a href="/test/user/doDel/id/<?php echo $user['id']; ?>">删除</a>
            </td>
        </tr>
        <?php endforeach; ?>
    </table>
</body>
</html>

添加页 d:\php\ht\application\test\view\user\add.html

html 复制代码
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>添加用户</title>
</head>
<body>
    <h1>添加用户</h1>
    
    <form method="post" action="/test/user/doAdd">
        用户名:<input type="text" name="username"><br><br>
        密码:<input type="password" name="password"><br><br>
        <button type="submit">提交</button>
    </form>
</body>
</html>

🔑 访问路径总结

php 复制代码
┌────────────────────────────────────────────────────────┐
│  URL 路径              →  控制器        →  方法       │
├────────────────────────────────────────────────────────┤
│  /test                  →  Index      →  index()     │
│  /test/index            →  Index      →  index()     │
│  /test/user/lists       →  User       →  lists()    │
│  /test/user/add         →  User       →  add()      │
│  /test/user/doAdd       →  User       →  doAdd()     │
│  /test/user/edit/id/5   →  User       →  edit(id=5)  │
└────────────────────────────────────────────────────────┘

⚠️ 注意事项

  1. 控制器文件名必须和类名一致,且首字母大写
  2. 视图目录要和控制器名对应(User控制器 → view/user/)
  3. 视图文件要和控制器方法名对应(edit方法 → edit.html)
  4. 如果出现404,检查URL重写是否配置正确

相关推荐
大今野5 小时前
第 16 章计算机网络体系结构详解:OSI七层模型、TCP/IP四层协议、三次握手与四次挥手
网络协议·tcp/ip·php·专转本
Risehuxyc7 小时前
PHP能不能在参数里放匿名函数
开发语言·php
FungLeo10 小时前
FengCMS · PHP+MySQL 升级实录 · 内容写入一致性:锁等待超时与跨模型子树删除竞态
开发语言·mysql·php·工程实践·fengcms
FungLeo12 小时前
FengCMS · PHP+MySQL 升级实录 · MySQL DDL不能回滚:模型字段结构操作的失败续做
android·mysql·php·工程实践·fengcms
FungLeo1 天前
FengCMS · PHP+MySQL 升级实录 · 危险默认值之殇:root/123456、认证码 8888 写进配置加载器
android·mysql·php·安全加固·fengcms
严肃小白兔1 天前
PHP 8.6 正式发布:部分函数应用、原生 I/O 轮询与新特性实战解析
开发语言·php
FungLeo1 天前
FengCMS · PHP+MySQL升级实录 ·并发一致性连环坑:模板缓存、排队保存、备份恢复的竞态
mysql·缓存·php·工程实践·fengcms
FungLeo1 天前
FengCMS · PHP+MySQL 升级实录·模型导入从“加密 SQL 码“到.fengmodel.json
sql·mysql·php·工程实践·fengcms
赤生云电竞2 天前
云游戏边缘节点部署实践:机房选址与网络拓扑选型
网络·游戏·php
CCIE-Yasuo2 天前
网络安全-PHP基础3
安全·web安全·php