PHP项目安全与鲁棒性

wen PHP项目 2026-07-19 191

PHP项目安全与鲁棒性实践指南

核心安全防护

输入验证与过滤

// 推荐：使用filter_var进行输入验证
$email = filter_var($_POST['email'], FILTER_VALIDATE_EMAIL);
if (!$email) {
    throw new InvalidArgumentException('Invalid email format');
}
// 使用htmlspecialchars防止XSS
echo htmlspecialchars($userInput, ENT_QUOTES, 'UTF-8');
// 使用strip_tags移除不需要的HTML标签
$cleanText = strip_tags($userInput, '<p><a>'); // 只保留特定标签

SQL注入防护

// 推荐：使用PDO预处理语句
$stmt = $pdo->prepare('SELECT * FROM users WHERE email = :email AND status = :status');
$stmt->execute([
    ':email' => $email,
    ':status' => 1
]);
$user = $stmt->fetch();
// 使用ORM框架（如Eloquent/Doctrine）自动处理
$users = User::where('email', $email)->where('status', 1)->get();

CSRF防护

// 生成Token
session_start();
if (empty($_SESSION['csrf_token'])) {
    $_SESSION['csrf_token'] = bin2hex(random_bytes(32));
}
// 表单中包含Token
echo '<input type="hidden" name="csrf_token" value="' . $_SESSION['csrf_token'] . '">';
// 验证Token
if (!hash_equals($_SESSION['csrf_token'], $_POST['csrf_token'])) {
    throw new Exception('CSRF token validation failed');
}

密码安全

// 使用password_hash/password_verify
$hashedPassword = password_hash($password, PASSWORD_BCRYPT, ['cost' => 12]);
// 验证密码
if (password_verify($inputPassword, $storedHash)) {
    // 密码正确
}
// 避免使用MD5/SHA1等弱哈希算法
// 不推荐：$hashed = md5($password);

文件上传安全

// 验证文件类型
$allowedTypes = ['image/jpeg', 'image/png', 'image/gif'];
$finfo = finfo_open(FILEINFO_MIME_TYPE);
$mimeType = finfo_file($finfo, $_FILES['file']['tmp_name']);
if (!in_array($mimeType, $allowedTypes)) {
    throw new Exception('Invalid file type');
}
// 限制文件大小
$maxSize = 5 * 1024 * 1024; // 5MB
if ($_FILES['file']['size'] > $maxSize) {
    throw new Exception('File too large');
}
// 生成唯一文件名
$extension = pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION);
$newFilename = uniqid() . '.' . $extension;
move_uploaded_file($_FILES['file']['tmp_name'], UPLOAD_DIR . $newFilename);

鲁棒性设计

错误处理

// 使用try-catch处理异常
try {
    // 业务逻辑
    $result = $service->processData($input);
} catch (ValidationException $e) {
    // 验证错误
    http_response_code(422);
    echo json_encode(['error' => $e->getMessage()]);
} catch (DatabaseException $e) {
    // 数据库错误
    error_log($e->getMessage());
    http_response_code(500);
    echo json_encode(['error' => 'Internal server error']);
}
// 自定义错误处理
set_error_handler(function($severity, $message, $file, $line) {
    throw new ErrorException($message, 0, $severity, $file, $line);
});

输入数据验证

// 使用验证库（如Respect Validation）
use Respect\Validation\Validator as v;
$validator = v::key('name', v::stringType()->notEmpty())
    ->key('email', v::email())
    ->key('age', v::intVal()->between(18, 65));
try {
    $validator->assert($_POST);
} catch (Respect\Validation\Exceptions\NestedValidationException $e) {
    // 处理验证错误
    $errors = $e->getFullMessages();
}
// 自定义验证函数
function validateDate(string $date, string $format = 'Y-m-d'): bool {
    $d = DateTime::createFromFormat($format, $date);
    return $d && $d->format($format) === $date;
}

日志记录

// 使用Monolog库
use Monolog\Logger;
use Monolog\Handler\StreamHandler;
use Monolog\Handler\RotatingFileHandler;
$logger = new Logger('app');
$logger->pushHandler(new RotatingFileHandler('/var/log/app.log', 30));
// 记录不同级别日志
$logger->info('User logged in', ['user_id' => $userId]);
$logger->warning('Failed login attempt', ['ip' => $ip]);
$logger->error('Database connection failed', ['exception' => $e]);
// 结构化日志
$logger->info('Order processed', [
    'order_id' => $orderId,
    'amount' => $amount,
    'duration_ms' => $executionTime
]);

配置管理

// 使用环境变量
$dbConfig = [
    'host' => getenv('DB_HOST'),
    'port' => getenv('DB_PORT', '3306'),
    'name' => getenv('DB_NAME'),
    'user' => getenv('DB_USER'),
    'password' => getenv('DB_PASSWORD')
];
// 配置文件示例 (config/app.php)
return [
    'debug' => filter_var(getenv('APP_DEBUG'), FILTER_VALIDATE_BOOLEAN),
    'url' => rtrim(getenv('APP_URL'), '/'),
    'timezone' => getenv('APP_TIMEZONE', 'UTC')
];
// 使用配置对象
class Config {
    private array $config;
    public function get(string $key, $default = null) {
        return $this->config[$key] ?? $default;
    }
    public function has(string $key): bool {
        return isset($this->config[$key]);
    }
}

性能优化

// 使用OPcache
// php.ini配置:
// opcache.enable=1
// opcache.memory_consumption=128
// opcache.max_accelerated_files=10000
// 数据库查询优化
$users = User::select(['id', 'name', 'email'])
    ->where('status', 1)
    ->with('profile') // 预加载关联
    ->paginate(20);   // 分页
// 缓存层
$cacheKey = 'user_data_' . $userId;
$userData = cache()->remember($cacheKey, 3600, function() use ($userId) {
    return User::findOrFail($userId)->toArray();
});
// 异步处理
dispatch(new ProcessLargeFile($fileId))->onQueue('high');

部署安全

服务器配置

# Nginx配置示例
server {
    listen 443 ssl;
    # 安全头
    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-Content-Type-Options "nosniff";
    add_header X-XSS-Protection "1; mode=block";
    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains";
    # 禁止访问敏感文件
    location ~ /\. {
        deny all;
    }
    location ~ /(config|vendor)/ {
        deny all;
    }
}

PHP配置

; php.ini安全配置
expose_php = Off
display_errors = Off
log_errors = On
error_log = /var/log/php_errors.log
allow_url_fopen = Off
allow_url_include = Off
session.cookie_httponly = 1
session.cookie_secure = 1
session.use_strict_mode = 1

依赖管理

// composer.json 安全配置
{
    "require": {
        "php": "^8.0",
        "ext-pdo": "*",
        "ext-json": "*"
    },
    "config": {
        "secure-http": true
    },
    "scripts": {
        "post-install-cmd": [
            "php artisan vendor:publish --tag=security"
        ]
    }
}

持续监控

安全审计

// 实现安全审计日志
class AuditLogger {
    public function log(string $action, array $data = []): void {
        DB::table('audit_logs')->insert([
            'user_id' => auth()->id(),
            'action' => $action,
            'data' => json_encode($data),
            'ip_address' => request()->ip(),
            'user_agent' => request()->userAgent(),
            'created_at' => now()
        ]);
    }
}
// 使用事件系统
Event::listen('user.login', function ($user) {
    audit()->log('user.login', ['email' => $user->email]);
});

健康检查

// 实现健康检查端点
Route::get('/health', function () {
    $checks = [
        'database' => function() {
            try {
                DB::connection()->getPdo();
                return ['status' => 'ok'];
            } catch (\Exception $e) {
                return ['status' => 'error', 'message' => $e->getMessage()];
            }
        },
        'cache' => function() {
            try {
                cache()->set('health_check', true, 1);
                return ['status' => 'ok'];
            } catch (\Exception $e) {
                return ['status' => 'error'];
            }
        }
    ];
    $results = [];
    $healthy = true;
    foreach ($checks as $name => $check) {
        $result = $check();
        $results[$name] = $result;
        if ($result['status'] !== 'ok') {
            $healthy = false;
        }
    }
    return response()->json([
        'status' => $healthy ? 'healthy' : 'unhealthy',
        'checks' => $results
    ]);
});