Symfony实战：构建用户登录系统与分页列表

构建用户登录系统

为了实现用户交互，首先需要在布局文件中添加登录入口，并创建对应的用户模块来处理登录逻辑。

第1步：添加全局导航链接

目的是在前端页面的布局文件中插入登录链接，方便用户访问。打开 apps/frontend/templates/layout.php 文件，在适当位置（如调试工具栏上方或About链接前）添加以下代码：

<li><?php echo link_to('sign in', 'user/login') ?></li>

注意：如果在页面上看不到该链接，可能是因为被Web调试工具栏遮挡，点击'Sf'图标折叠调试栏即可显现。

第2步：生成User模块框架

使用命令行工具生成基础模块结构，随后自行编写具体逻辑。执行命令：

$ symfony init-module frontend user

生成的 index 动作和模板并非必需，可以删除以保持项目整洁。

第3步：编写Login动作与模板

首先创建 user/actions/action.class.php 中的 executeLogin 动作。初始版本仅用于保存来源页面地址并返回成功视图：

public function executeLogin()
{
  $this->getRequest()->setAttribute('referer', $this->getRequest()->getReferer());
  return sfView::SUCCESS;
}

接着，在 user/templates/loginSuccess.php 中构建表单HTML。利用Symfony的表单辅助函数简化代码：

<?php echo form_tag('user/login') ?>
  <fieldset>
    <div class="form-row">
      <label for="nickname">Nickname:</label>
      <?php echo input_tag('nickname', $sf_params->get('nickname')) ?>
    </div>
    <div class="form-row">
      <label for="password">Password:</label>
      <?php echo input_password_tag('password') ?>
    </div>
  </fieldset>
  <?php echo input_hidden_tag('referer', $sf_request->getAttribute('referer')) ?>
  <?php echo submit_tag('sign in') ?>
</form>

第4步：处理表单提交与身份验证

修改 executeLogin 动作以区分GET（显示表单）和POST（处理提交）请求，并完成数据库查询与会话设置：

public function executeLogin()
{
  if ($this->getRequest()->getMethod() != sfRequest::POST)
  {
    $this->getRequest()->setAttribute('referer', $this->getRequest()->getReferer());
  }
  else
  {
    // 获取昵称并查询用户
    $nickname = $this->getRequestParameter('nickname');
    $c = new Criteria();
    $c->add(UserPeer::NICKNAME, $nickname);
    $user = UserPeer::doSelectOne($c);

    if ($user) // 假设密码验证通过
    {
      // 设置认证状态与凭证
      $this->getUser()->setAuthenticated(true);
      $this->getUser()->addCredential('subscriber');

      // 存储会话属性至特定命名空间
      $this->getUser()->setAttribute('subscriber_id', $user->getId(), 'subscriber');
      $this->getUser()->setAttribute('nickname', $user->getNickname(), 'subscriber');

      // 重定向回原页面
      return $this->redirect($this->getRequestParameter('referer', '@homepage'));
    }
  }
}

关键点说明：
- request attributes 仅在当前请求中有效，适合传递临时数据如 referer。
- session attributes 跨请求保存，用于存储用户身份信息。
- 命名空间（如 'subscriber'）有助于隔离不同模块的用户数据。

第5步：实现登出功能

在 action.class.php 中添加 executeLogout 动作，清理会话并重置认证状态：

public function executeLogout()
{
  $this->getUser()->setAuthenticated(false);
  $this->getUser()->clearCredentials();
  $this->getUser()->getAttributeHolder()->removeNamespace('subscriber');
  $this->redirect('@homepage');
}

第6步：动态更新布局导航

根据用户是否已登录，在 layout.php 中切换显示的链接：

<?php if ($sf_user->isAuthenticated()): ?>
  <li><?php echo link_to('sign out', 'user/logout') ?></li>
  <li><?php echo link_to($sf_user->getAttribute('nickname', '', 'subscriber').' profile', 'user/profile') ?></li>
<?php else: ?>
  <li><?php echo link_to('sign in/register', 'user/login') ?></li>
<?php endif ?>

实现列表分页浏览

当数据量增大时，全量加载会影响性能。使用 sfPropelPager 对象可实现高效的分页查询。

第7步：配置Pager对象

修改 question/actions/action.class.php 中的 executeList 方法：

public function executeList()
{
  // 建议使用配置文件参数定义每页数量
  $pager = new sfPropelPager('Question', sfConfig::get('app_pager_homepage_max'));
  
  // 设置排序条件：按感兴趣用户数降序
  $c = new Criteria();
  $c->addDescendingOrderByColumn(QuestionPeer::INTERESTED_USERS);
  $pager->setCriteria($c);
  
  // 设置当前页码，默认为1
  $pager->setPage($this->getRequestParameter('page', 1));
  
  // 关联查询User表以获取详细信息
  $pager->setPeerMethod('doSelectJoinUser');
  $pager->init();
  
  $this->question_pager = $pager;
}

第8步：更新模板与分页控件

在 listSuccess.php 中遍历分页结果，并添加翻页链接：

<?php foreach($question_pager->getResults() as $question): ?>
  <!-- 问题展示代码 -->
<?php endforeach; ?>

<div id="question_pager">
<?php if ($question_pager->haveToPaginate()): ?>
  <?php echo link_to('&laquo;', 'question/list?page=1') ?>
  <?php echo link_to('&lt;', 'question/list?page='.$question_pager->getPreviousPage()) ?>
  
  <?php foreach ($question_pager->getLinks() as $page): ?>
    <?php echo link_to_unless($page == $question_pager->getPage(), $page, 'question/list?page='.$page) ?>
    <?php echo ($page != $question_pager->getCurrentMaxLink()) ? '-' : '' ?>
  <?php endforeach; ?>
  
  <?php echo link_to('&gt;', 'question/list?page='.$question_pager->getNextPage()) ?>
  <?php echo link_to('&raquo;', 'question/list?page='.$question_pager->getLastPage()) ?>
<?php endif; ?>
</div>

这里使用了 link_to_unless 辅助函数：如果测试条件为假，则输出普通链接；否则输出纯文本。

第9步：优化URL路由规则

默认的URL结构较为冗长，可通过 routing.yml 配置简洁的路径：

popular_questions:
  url:   /index/:page
  param: { module: question, action: list }

login:
  url:   /login
  param: { module: user, action: login }

代码重构建议

为了保持MVC结构的清晰度，应将业务逻辑从Controller移至Model层，并从View中提取重复的代码片段。

• 模型层 (lib/model/QuestionPeer.php)：将分页逻辑封装为静态方法 getHomepagePager，并在 executeList 中调用它。
• 视图层 (question/templates/_list.php)：将问题列表渲染代码提取为Partial片段，listSuccess.php 仅保留标题和 include_partial 调用，提高复用性。

以上就是Symfony表单与页面实现技巧的详细内容，更多关于Symfony用户认证与分页的资料请关注本站其它相关文章！