讲师中心 微信公众号
AI工具推荐 视频效率加速

ThinkPHP 5.1手册怎么使用?控制器与模型创建全攻略

阿明大大_8583

阿明大大_8583

发布时间:2026-08-10 14:35:19

|

803人浏览过

|

来源于php中文网

原创

ThinkPHP 5.1控制器与模型需严格遵循命名规范和目录结构:命令行php think make:controller index/User自动生成正确命名空间、类名及继承;控制器方法名小写开头,URL自动转下划线;模型推荐命令行生成并映射表名,调用须use引入后静态调用;多模块需think build创建,单模块需关闭app_multi_module并调整目录与命名空间。

thinkphp 5.1手册怎么使用?控制器与模型创建全攻略

想快速上手ThinkPHP 5.1开发,却卡在控制器和模型怎么建、怎么调用、怎么命名这些基础环节?官方手册条目多但分散,新手常因命名空间错位、目录结构不匹配、命令执行路径不对导致404或类找不到。

用命令行一键生成控制器

进入项目根目录(含think可执行文件),运行:
php think make:controller index/User

这会在application/index/controller/下生成User.php文件,自动完成命名空间声明、类名驼峰大写、继承think\Controller三件事。手动创建时若漏掉namespace app\index\controller;,访问时直接报Class not found。

控制器方法名必须小写字母开头,如detail();若方法名为getInfo(),URL中需写成get_info(下划线分隔)。【文件名User.php与类名User必须完全一致,大小写敏感】

立即学习“PHP免费学习笔记(深入)”;

模型创建的两种方式

方法一:命令行生成(推荐)
php think make:model index/User

生成文件位于application/index/model/User.php,自动设置命名空间、继承think\Model,并按约定将User映射到users表。若实际表名是tp_user,需在模型中显式声明protected $table = 'tp_user';

方法二:手动创建
在application/index/model/下新建User.php,内容必须包含:

namespace app\index\model;
use think\Model;
class User extends Model { protected $table = 'tp_user'; }

注意:手动创建时,若忘记use think\Model;,后续调用where()、find()等方法会提示Call to undefined method。

btpanel phpsite 宝塔面板PHP网站
btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理:站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

控制器里调用模型的正确姿势

第一步:在控制器顶部引入模型类
use app\index\model\User;

第二步:在方法内实例化并查询
$user = User::where('id', 1)->find();

第三步:返回结果
return json($user);

不要用new User()——ThinkPHP 5.1模型支持静态调用,new方式会绕过框架的初始化逻辑,导致事件、验证器等失效。如果模型类名与控制器类名冲突(比如都有User),可用别名:use app\index\model\User as UserModel;

多模块下控制器与模型的路径映射

① 创建新模块NewModule:
php think build --module NewModule

② 在application/NewModule/controller/下建Index.php,命名空间必须为app\NewModule\controller;
③ 对应模型放在application/NewModule/model/User.php,命名空间为app\NewModule\model;
④ 访问地址为:http://localhost/NewModule/index/index

若跳过①直接手工建目录,框架无法识别模块,请求会被路由丢弃。模块名NewModule首字母必须大写,否则build命令生成的命名空间会出错。

单模块模式下的精简配置

编辑config/app.php,把'app_multi_module' => true改为false;
删除application目录下的所有模块子文件夹(如index),只保留controller、model、view三个顶层目录;
控制器文件直接放在application/controller/User.php,命名空间变为app\controller;
模型文件放application/model/User.php,命名空间变为app\model。

此时URL变为:http://localhost/user/index,不再需要模块名前缀。启用单模块后,【原有模块目录结构将被忽略,旧路由全部失效】

相关文章

热门游戏推荐
热门游戏推荐

海量精品小游戏合集,无需安装即点即玩,休闲益智、动作闯关应有尽有,秒开即玩,轻松解压,快乐停不下来

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
Docker Desktop怎么设置端口映射
Docker Desktop怎么设置端口映射

本专题聚焦Docker Desktop容器端口映射与访问配置,整理从创建容器、设置端口绑定到验证本地服务访问的操作流程。针对端口被占用、映射配置错误、容器服务无法访问等情况,也提供相应的检查方向,方便用户完成端口配置。

0

2026.11.03

Docker Desktop镜像构建教程
Docker Desktop镜像构建教程

想使用Docker Desktop将本地项目构建成Docker镜像?本专题围绕镜像构建的实际操作展开,介绍Dockerfile编写、构建命令使用、镜像标签设置和构建日志查看等内容,同时整理镜像无法生成、依赖安装失败及构建缓存异常等问题的排查思路。

0

2026.11.03

Docker Desktop容器创建指南
Docker Desktop容器创建指南

本专题聚焦Docker Desktop容器创建与运行配置,介绍通过本地镜像或远程镜像创建容器的方法,以及容器启动、终端访问、日志查看和基础管理等操作。针对端口冲突、参数配置不当、容器无法启动等情况,也整理了相应的排查方向。

0

2026.11.03

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

0

2026.11.03

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

0

2026.11.03

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

0

2026.11.03

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

0

2026.11.03

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

20

2026.11.02

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

40

2026.11.02

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn