本文目录导读：
我来详细讲解PHP结构化内容的方法和最佳实践。
代码结构组织
基础目录结构
project/
├── index.php # 入口文件
├── config/ # 配置目录
│ └── database.php
├── includes/ # 公共文件
│ ├── header.php
│ └── footer.php
├── classes/ # 类文件
│ ├── User.php
│ └── Database.php
├── functions/ # 函数文件
│ └── helpers.php
├── templates/ # 模板文件
│ └── user_list.php
└── assets/ # 静态资源
├── css/
├── js/
└── images/使用函数组织代码
<?php
// functions/helpers.php
function connectDatabase($host, $user, $password, $dbname) {
$conn = new mysqli($host, $user, $password, $dbname);
if ($conn->connect_error) {
die("Connection failed: " . $conn->connect_error);
}
return $conn;
}
function sanitizeInput($data) {
$data = trim($data);
$data = stripslashes($data);
$data = htmlspecialchars($data);
return $data;
}
function getUserById($conn, $userId) {
$sql = "SELECT * FROM users WHERE id = ?";
$stmt = $conn->prepare($sql);
$stmt->bind_param("i", $userId);
$stmt->execute();
return $stmt->get_result()->fetch_assoc();
}
?>
面向对象编程(OOP)
<?php
// classes/User.php
class User {
private $id;
private $username;
private $email;
private $db;
public function __construct($db) {
$this->db = $db;
}
// Getter 和 Setter
public function getId() {
return $this->id;
}
public function setUsername($username) {
$this->username = $username;
}
public function getUsername() {
return $this->username;
}
// 业务方法
public function create($data) {
$sql = "INSERT INTO users (username, email) VALUES (?, ?)";
$stmt = $this->db->prepare($sql);
$stmt->bind_param("ss", $data['username'], $data['email']);
return $stmt->execute();
}
public function findById($id) {
$sql = "SELECT * FROM users WHERE id = ?";
$stmt = $this->db->prepare($sql);
$stmt->bind_param("i", $id);
$stmt->execute();
$result = $stmt->get_result();
return $result->fetch_assoc();
}
}
?>
模板分离（MVC模式基础）
<?php // index.php - 控制器部分 require_once 'config/database.php'; require_once 'classes/User.php'; $db = new Database(); $userModel = new User($db); // 获取用户列表 $users = $userModel->getAllUsers(); // 包含视图 include 'templates/user_list.php'; ?>
<!-- templates/user_list.php - 视图部分 -->
<!DOCTYPE html>
<html>
<head>用户列表</title>
</head>
<body>
<h1>用户列表</h1>
<?php if (!empty($users)): ?>
<table>
<thead>
<tr>
<th>ID</th>
<th>用户名</th>
<th>邮箱</th>
</tr>
</thead>
<tbody>
<?php foreach ($users as $user): ?>
<tr>
<td><?php echo htmlspecialchars($user['id']); ?></td>
<td><?php echo htmlspecialchars($user['username']); ?></td>
<td><?php echo htmlspecialchars($user['email']); ?></td>
</tr>
<?php endforeach; ?>
</tbody>
</table>
<?php else: ?>
<p>没有用户数据</p>
<?php endif; ?>
</body>
</html>
使用命名空间
<?php
// classes/Database.php
namespace App\Database;
class Database {
private $connection;
public function connect() {
// 连接代码
}
}
?>
<?php
// 使用命名空间
use App\Database\Database;
$db = new Database();
$db->connect();
?>
配置文件管理
<?php
// config/app.php
return [
'app_name' => 'My Application',
'debug' => true,
'database' => [
'host' => 'localhost',
'user' => 'root',
'password' => '',
'dbname' => 'myapp'
],
'upload' => [
'max_size' => 5242880, // 5MB
'allowed_types' => ['jpg', 'png', 'pdf']
]
];
?>
<?php
// 使用配置
$config = require 'config/app.php';
$dbConfig = $config['database'];
?>
自动加载 (Autoloading)
<?php
// 使用 Composer 的自动加载
require 'vendor/autoload.php';
// 或者自定义自动加载
spl_autoload_register(function ($class) {
$prefix = 'App\\';
$baseDir = __DIR__ . '/src/';
$len = strlen($prefix);
if (strncmp($prefix, $class, $len) !== 0) {
return;
}
$relativeClass = substr($class, $len);
$file = $baseDir . str_replace('\\', '/', $relativeClass) . '.php';
if (file_exists($file)) {
require $file;
}
});
?>
最佳实践总结
- 单一职责原则：每个文件/类只负责一个功能
- 代码复用：使用函数和类避免重复代码
- 安全考虑：始终进行输入验证和输出转义
- 错误处理：使用 try-catch 和自定义错误处理
- 注释文档：添加清晰的注释和文档
这种结构化方式能让你的PHP代码更加：
- 可维护：易于理解和修改
- 可扩展：方便添加新功能
- 可测试：便于单元测试
- 可重用：代码可以在不同项目中复用
