CodeIgniter框架教程：静态页面的创建与管理-优快云博客

CodeIgniter框架教程：静态页面的创建与管理

【免费下载链接】CodeIgniter Open Source PHP Framework (originally from EllisLab) 项目地址: https://gitcode.com/gh_mirrors/co/CodeIgniter

引言：为什么需要静态页面管理系统？

在现代Web开发中，静态页面（Static Pages）仍然是网站不可或缺的组成部分。无论是关于我们、联系方式、服务条款还是隐私政策页面，这些内容相对固定但至关重要的页面都需要一个高效的管理系统。CodeIgniter作为轻量级的PHP框架，提供了简洁而强大的工具来创建和管理静态页面。

通过本教程，您将学会：

✅ 创建专业的静态页面控制器
✅ 实现智能的路由配置
✅ 构建可重用的模板系统
✅ 处理404错误和页面验证
✅ 优化URL结构和SEO友好性

环境准备与项目结构

系统要求

# 确保您的环境满足以下要求
PHP版本: 5.6+ (推荐7.2+)
Web服务器: Apache/Nginx
数据库: MySQL/PostgreSQL/SQLite (可选)

项目目录结构

mermaid

核心实现步骤

1. 创建静态页面控制器

首先创建主要的页面控制器 application/controllers/Pages.php：

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

class Pages extends CI_Controller {
    
    /**
     * 显示静态页面
     * @param string $page 页面名称，默认为'home'
     */
    public function view($page = 'home')
    {
        // 验证页面是否存在
        if (!file_exists(APPPATH . 'views/pages/' . $page . '.php')) {
            // 页面不存在时显示404错误
            show_404();
        }
        
        // 准备页面数据
        $data['title'] = ucfirst($page); // 首字母大写
        $data['current_page'] = $page;
        $data['meta_description'] = $this->getMetaDescription($page);
        
        // 加载页面模板
        $this->load->view('templates/header', $data);
        $this->load->view('pages/' . $page, $data);
        $this->load->view('templates/footer', $data);
    }
    
    /**
     * 获取页面meta描述
     * @param string $page 页面名称
     * @return string meta描述内容
     */
    private function getMetaDescription($page)
    {
        $descriptions = [
            'home' => '欢迎访问我们的网站，提供优质的服务和产品',
            'about' => '关于我们的公司历史、团队和使命',
            'contact' => '联系我们获取更多信息和支持',
            'services' => '我们提供的专业服务和服务范围',
            'privacy' => '隐私政策和使用条款说明'
        ];
        
        return isset($descriptions[$page]) ? $descriptions[$page] : '页面描述';
    }
    
    /**
     * 获取所有可用页面列表
     * @return array 页面列表
     */
    public function getPageList()
    {
        $pages = [];
        $files = glob(APPPATH . 'views/pages/*.php');
        
        foreach ($files as $file) {
            $pageName = basename($file, '.php');
            if ($pageName !== 'index') {
                $pages[] = $pageName;
            }
        }
        
        return $pages;
    }
}

2. 创建模板系统

头部模板 `application/views/templates/header.php`

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta name="description" content="<?php echo $meta_description; ?>">
    <title><?php echo $title; ?> - 我的网站</title>
    
    <!-- Bootstrap CSS CDN -->
    <link href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.1.3/css/bootstrap.min.css" rel="stylesheet">
    
    <style>
        .navbar-brand {
            font-weight: bold;
            font-size: 1.5rem;
        }
        .active {
            font-weight: bold;
            color: #007bff !important;
        }
    </style>
</head>
<body>
    <nav class="navbar navbar-expand-lg navbar-light bg-light">
        <div class="container">
            <a class="navbar-brand" href="<?php echo base_url(); ?>">我的网站</a>
            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
                <span class="navbar-toggler-icon"></span>
            </button>
            <div class="collapse navbar-collapse" id="navbarNav">
                <ul class="navbar-nav ms-auto">
                    <li class="nav-item">
                        <a class="nav-link <?php echo ($current_page == 'home') ? 'active' : ''; ?>" 
                           href="<?php echo base_url('home'); ?>">首页</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link <?php echo ($current_page == 'about') ? 'active' : ''; ?>" 
                           href="<?php echo base_url('about'); ?>">关于我们</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link <?php echo ($current_page == 'services') ? 'active' : ''; ?>" 
                           href="<?php echo base_url('services'); ?>">服务</a>
                    </li>
                    <li class="nav-item">
                        <a class="nav-link <?php echo ($current_page == 'contact') ? 'active' : ''; ?>" 
                           href="<?php echo base_url('contact'); ?>">联系我们</a>
                    </li>
                </ul>
            </div>
        </div>
    </nav>
    
    <div class="container mt-4">

底部模板 `application/views/templates/footer.php`

    </div>
    
    <footer class="bg-dark text-light py-4 mt-5">
        <div class="container">
            <div class="row">
                <div class="col-md-6">
                    <h5>我的网站</h5>
                    <p>提供优质的服务和解决方案</p>
                </div>
                <div class="col-md-6 text-md-end">
                    <p>&copy; <?php echo date('Y'); ?> 我的网站. 保留所有权利.</p>
                    <p>
                        <a href="<?php echo base_url('privacy'); ?>" class="text-light">隐私政策</a> | 
                        <a href="<?php echo base_url('terms'); ?>" class="text-light">使用条款</a>
                    </p>
                </div>
            </div>
        </div>
    </footer>

    <!-- Bootstrap JS CDN -->
    <script src="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/5.1.3/js/bootstrap.bundle.min.js"></script>
</body>
</html>

3. 创建静态页面内容

首页 `application/views/pages/home.php`

<div class="row">
    <div class="col-12">
        <div class="jumbotron bg-light p-5 rounded">
            <h1 class="display-4">欢迎访问我们的网站</h1>
            <p class="lead">我们致力于提供最优质的服务和解决方案，帮助您实现业务目标。</p>
            <hr class="my-4">
            <p>探索我们的服务，了解我们如何帮助您取得成功。</p>
            <a class="btn btn-primary btn-lg" href="<?php echo base_url('services'); ?>" role="button">了解更多</a>
        </div>
    </div>
</div>

<div class="row mt-4">
    <div class="col-md-4">
        <div class="card">
            <div class="card-body">
                <h5 class="card-title">专业服务</h5>
                <p class="card-text">我们提供全方位的专业服务，满足您的各种需求。</p>
            </div>
        </div>
    </div>
    <div class="col-md-4">
        <div class="card">
            <div class="card-body">
                <h5 class="card-title">经验丰富</h5>
                <p class="card-text">拥有多年的行业经验，为您提供可靠的解决方案。</p>
            </div>
        </div>
    </div>
    <div class="col-md-4">
        <div class="card">
            <div class="card-body">
                <h5 class="card-title">客户支持</h5>
                <p class="card-text">24/7客户支持，确保您的问题得到及时解决。</p>
            </div>
        </div>
    </div>
</div>

关于我们页面 `application/views/pages/about.php`

<div class="row">
    <div class="col-12">
        <h1>关于我们</h1>
        <p class="lead">我们是一家致力于创新和技术卓越的公司。</p>
        
        <div class="row mt-4">
            <div class="col-md-6">
                <h3>我们的使命</h3>
                <p>通过创新和技术，为客户提供卓越的解决方案，推动行业进步。</p>
            </div>
            <div class="col-md-6">
                <h3>我们的愿景</h3>
                <p>成为行业领导者，通过技术改变世界，创造更美好的未来。</p>
            </div>
        </div>
        
        <div class="mt-4">
            <h3>公司历史</h3>
            <p>成立于2010年，我们从小型创业公司发展成为行业的重要参与者。</p>
            
            <table class="table table-striped mt-3">
                <thead>
                    <tr>
                        <th>年份</th>
                        <th>里程碑</th>
                    </tr>
                </thead>
                <tbody>
                    <tr>
                        <td>2010</td>
                        <td>公司成立，开始提供基础服务</td>
                    </tr>
                    <tr>
                        <td>2015</td>
                        <td>用户数量突破10万，获得行业奖项</td>
                    </tr>
                    <tr>
                        <td>2020</td>
                        <td>推出创新产品，市场份额显著增长</td>
                    </tr>
                    <tr>
                        <td>2023</td>
                        <td>成为行业领导者，服务覆盖全球</td>
                    </tr>
                </tbody>
            </table>
        </div>
    </div>
</div>

4. 配置路由系统

修改 application/config/routes.php 文件：

<?php
defined('BASEPATH') OR exit('No direct script access allowed');

// 默认控制器设置为Pages控制器的view方法
$route['default_controller'] = 'pages/view';

// 404页面重写
$route['404_override'] = '';

// 转换URI中的破折号
$route['translate_uri_dashes'] = FALSE;

// 静态页面路由配置
$route['(:any)'] = 'pages/view/$1';

// 特定页面的自定义路由（可选）
$route['home'] = 'pages/view/home';
$route['about'] = 'pages/view/about';
$route['contact'] = 'pages/view/contact';
$route['services'] = 'pages/view/services';
$route['privacy'] = 'pages/view/privacy';
$route['terms'] = 'pages/view/terms';

5. 高级功能扩展

5.1 多语言支持

创建多语言版本的路由和控制器：

// 在Pages控制器中添加多语言支持
public function view($page = 'home', $lang = 'zh')
{
    // 设置语言
    $this->config->set_item('language', $lang);
    $this->lang->load('pages', $lang);
    
    // 验证页面是否存在
    $viewPath = APPPATH . 'views/' . $lang . '/pages/' . $page . '.php';
    if (!file_exists($viewPath)) {
        show_404();
    }
    
    $data['title'] = lang('page_' . $page . '_title');
    $data['current_page'] = $page;
    $data['current_lang'] = $lang;
    
    $this->load->view($lang . '/templates/header', $data);
    $this->load->view($lang . '/pages/' . $page, $data);
    $this->load->view($lang . '/templates/footer', $data);
}

5.2 页面缓存优化

添加页面缓存功能提升性能：

// 在view方法中添加缓存支持
public function view($page = 'home')
{
    // 启用页面缓存（5分钟）
    $this->output->cache(5);
    
    if (!file_exists(APPPATH . 'views/pages/' . $page . '.php')) {
        show_404();
    }
    
    $data['title'] = ucfirst($page);
    $data['current_page'] = $page;
    
    $this->load->view('templates/header', $data);
    $this->load->view('pages/' . $page, $data);
    $this->load->view('templates/footer', $data);
}

6. 错误处理与验证

自定义404错误页面

创建 application/views/errors/html/error_404.php：

<div class="container text-center mt-5">
    <div class="row">
        <div class="col-12">
            <h1 class="display-1 text-muted">404</h1>
            <h2>页面未找到</h2>
            <p class="lead">抱歉，您访问的页面不存在。</p>
            <p>请检查URL是否正确，或返回<a href="<?php echo base_url(); ?>">首页</a>。</p>
            
            <div class="mt-4">
                <a href="<?php echo base_url(); ?>" class="btn btn-primary">返回首页</a>
                <a href="javascript:history.back()" class="btn btn-secondary">返回上一页</a>
            </div>
        </div>
    </div>
</div>

7. 性能优化建议

7.1 使用OPcache加速

; php.ini 配置
opcache.enable=1
opcache.memory_consumption=128
opcache.max_accelerated_files=10000
opcache.revalidate_freq=300

7.2 数据库连接优化

如果使用数据库，确保连接池配置合理：

// application/config/database.php
$db['default'] = [
    'dsn'   => '',
    'hostname' => 'localhost',
    'username' => 'your_username',
    'password' => 'your_password',
    'database' => 'your_database',
    'dbdriver' => 'mysqli',
    'dbprefix' => '',
    'pconnect' => FALSE, // 避免持久连接
    'cache_on' => FALSE,
    'cachedir' => '',
    'char_set' => 'utf8',
    'dbcollat' => 'utf8_general_ci',
    'swap_pre' => '',
    'encrypt' => FALSE,
    'compress' => FALSE,
    'stricton' => FALSE,
    'failover' => array(),
    'save_queries' => TRUE
];

总结与最佳实践

通过本教程，您已经学会了如何在CodeIgniter中创建和管理静态页面系统。以下是关键要点：

核心优势

简洁高效：CodeIgniter的轻量级架构使得静态页面管理变得简单
灵活路由：通过路由配置实现友好的URL结构
模板重用：头部和底部模板的复用减少代码重复
错误处理：完善的404错误处理机制

最佳实践表格

实践项目	推荐做法	避免做法
文件命名	使用小写字母和下划线	使用空格和特殊字符
路由配置	使用(:any)通配符	为每个页面单独写死路由
模板设计	分离header/footer	在每个页面重复代码
错误处理	自定义404页面	使用默认错误页面
性能优化	启用OPcache缓存	忽略服务器优化

扩展建议

集成CMS功能：添加后台管理界面来动态管理页面内容
SEO优化：为每个页面添加独立的meta标签和结构化数据
多主题支持：实现主题切换功能
访问统计：集成访问量统计和分析功能

故障排除指南

mermaid

通过遵循本教程的指导，您将能够构建出专业、高效且易于维护的静态页面管理系统。CodeIgniter框架的简洁性和灵活性使得这一过程变得简单而愉快。

记住，良好的代码结构和遵循最佳实践是项目成功的关键。不断优化和改进您的实现，以适应不断变化的业务需求和技术发展。

【免费下载链接】CodeIgniter Open Source PHP Framework (originally from EllisLab) 项目地址: https://gitcode.com/gh_mirrors/co/CodeIgniter

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

CodeIgniter框架教程：静态页面的创建与管理