joomla 5 开发必须遵循其运行上下文：废弃 jfactory::getdbo()，改用依赖注入或 factory::getcontainer()->get(databaseinterface::class)；组件需完整 admin. 前缀结构；模板中须用 jinput 而非 $_post；插件事件参数需引用传递。
直接学 Joomla 的 PHP 编程，不是从“PHP 语法”开始，而是从“Joomla 的运行上下文”切入——它不接受裸写 echo 或自由连接数据库，所有操作必须走它的工厂类、服务容器和约定路径。跳过这层认知，写出来的代码要么报错，要么被升级清空。
为什么 JFactory::getDBO() 在 Joomla 5 中已废弃
你查到的很多老教程（尤其是 2016–2020 年间的）还在用 JFactory::getDBO() 获取数据库对象，但 Joomla 4.0 起全面转向依赖注入和服务定位器模式。JFactory 类在 5.x 中已被标记为废弃，继续用会导致 E_DEPRECATED 警告，且在严格模式下直接失败。
正确做法是：在组件或插件的入口文件中，通过依赖注入获取 DatabaseInterface 实例；若在非标准上下文（如自定义脚本），改用 Factory::getContainer()->get(DatabaseInterface::class)。
- 旧写法（失效）：
$db = JFactory::getDBO(); - 新写法（Joomla 5+）：
$db = Factory::getContainer()->get(DatabaseInterface::class); - 注意：必须提前
use Joomla\CMS\Factory;和use Joomla\Database\DatabaseInterface; - 直接 new PDO 或 mysqli_connect 会绕过 Joomla 的查询日志、事务管理、前缀替换（
#_）等机制，导致功能异常或安全漏洞
组件开发时，com_mycomponent 的目录结构不能省略 admin. 前缀
新建一个前台可访问的组件，比如 com_books，很多人只建了 components/com_books/books.php，却忘了后台管理部分必须有 administrator/components/com_books/admin.books.php ——哪怕内容为空。否则安装后进后台菜单，点击该组件会 500 报错，错误信息通常是 Class 'BooksController' not found 或 Cannot load controller。
原因在于 Joomla 5 的 MVC 自动加载机制默认寻找 Administrator/Controller 命名空间下的控制器类，而该类路径映射依赖于 admin.books.php 这个引导文件的存在。
- 前台入口文件名必须是
components/com_xxx/xxx.php（小写，无com_前缀） - 后台入口文件名必须是
administrator/components/com_xxx/admin.xxx.php（admin.不可省略，小写） - 两者都必须包含
defined('_JEXEC') or die;校验 - 若后台文件缺失，Joomla 安装器可能不报错，但后台路由完全不可用
模板中调用 $this->params 是安全的，但直接读 $_POST 就会出问题
Joomla 模板（templates/mytemplate/index.php）里可以放心使用 $this->params 读取当前菜单项参数，也可以用 $this->item（在文章视图中）或 $this->category（在分类视图中）。但一旦你试图绕过框架直接处理表单数据，比如写 $_POST['email'] 或 $_GET['id']，就会踩中两个坑：
- CSRF 防护失效：Joomla 默认启用令牌验证（
JSession::checkToken()），裸读$_POST会跳过校验，导致提交被拒绝或后台提示 “Invalid Token” - 输入过滤丢失：Joomla 的
JInput对象默认对不同字段类型做自动清理（如整数转 int、HTML 过滤），直接读全局变量等于放弃这层防护 - 正确方式是：
$input = Factory::getApplication()->input;，再用$input->get('email', '', 'email')或$input->getInt('id') - 模板里不建议做业务逻辑，这类操作应放在组件控制器中完成
插件触发点（onContentPrepare）里修改 $article->text，别漏掉 & 引用符号
写内容插件时，常见需求是在文章正文渲染前插入广告或替换关键词。典型写法是监听 onContentPrepare 事件，然后操作 $article->text。但如果你写成：
$article->text = str_replace('old', 'new', $article->text);
在 Joomla 5 中大概率无效——因为传入的 $article 是值传递副本，不是引用。必须显式声明引用才能生效：
- 错误写法：
public function onContentPrepare($context, $article, $params, $page = 0) - 正确写法：
public function onContentPrepare($context, &$article, $params, $page = 0)（注意&$article） - 漏掉
&后，你的替换逻辑执行了，但原对象没变，前台照样显示旧内容 - 同理适用于
onUserLogin中修改$user、onAfterRoute中修改$app等场景
最易被忽略的是：Joomla 的事件签名变更不会报致命错误，只会静默失败。你得靠浏览器检查输出 + 日志（logs/error.php）交叉验证是否真被触发并生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
