当前位置： 维易PHP培训学院 > PHP学习 > 内容正文

PHP实战：Symfony页面的基本创建实例详解

作者：VEPHP   时间 2017-10-22

《PHP实战：Symfony页面的基本创建实例详解》要点：
本文介绍了PHP实战：Symfony页面的基本创建实例详解，希望对您有用。如果有疑问，可以联系我们。

本文实例分析了Symfony页面的基本创建办法.分享给大家供大家参考.具体如下：PHP应用

这里我们将会学习如何创建一个模块,这是组织页面的结构化元素.同时我们也会学习如何创创建一个分为一个动作也一个模板的页面,之所以分为动作与模板,是因为MVC模式.链接与表彰是基本的页面交互,我们将会学习如安在模板中插入这些元素并且在动作中进行处理.PHP应用

创建一个模块框架PHP应用

Symfony将页面组织为模块.在创建一个页面之前,我们需要创建一个模块,并且初始化为一个Symfony可以识别的文件结构的空壳.PHP应用

Symfony命令行自动化处理模块的创建.我们只需要调用init-module任务,并且使用程序名以及模块名作为参数.在创建了一个myapp程序之后,要向这个程序中添加一个mymodule模块,我们可以输入下面的命令：
PHP应用

代码如下:
> cd ~/myproject
> symfony init-module myapp mymodule

>> dir+      ~/myproject/apps/myapp/modules/mymodule
>> dir+      ~/myproject/apps/myapp/modules/mymodule/actions
>> file+     ~/myproject/apps/myapp/modules/mymodule/actions/actions.class.php
>> dir+      ~/myproject/apps/myapp/modules/mymodule/config
>> dir+      ~/myproject/apps/myapp/modules/mymodule/lib
>> dir+      ~/myproject/apps/myapp/modules/mymodule/templates
>> file+     ~/myproject/apps/myapp/modules/mymodule/templates/indexSuccess.php
>> dir+      ~/myproject/apps/myapp/modules/mymodule/validate
>> file+     ~/myproject/test/functional/myapp/mymoduleActionsTest.php
>> tokens    ~/myproject/test/functional/myapp/mymoduleActionsTest.php
>> tokens    ~/myproject/apps/myapp/modules/mymodule/actions/actions.class.php
>> tokens    ~/myproject/apps/myapp/modules/mymodule/templates/indexSuccess.phpPHP应用

与actions/,config/,lib/,templates/,validate/目录相分离,这个命令只创建三个文件.位于test/目录中的一个为单元测试.actions.class.php指向默认的模块欢迎页面.templates/indexSuccess.php文件为空.PHP应用

在actions/actions.class.php文件中默认生成的动作：
PHP应用

代码如下:
<?php
 class mymoduleActions extends sfActions
 {
   public function executeIndex()
     {
         $this->forward('default', 'module');
     }
   }
?>

对于每一个新的模块,Symfony会创建一个默认的index动作.他是由一个名为executeIndex的动作办法以及一个名为indexSuccess.php的模板文件组成.我们可以通过下面的URL来浏览相应的页面：
http://localhost/myapp_dev.php/mymodule/index
这里我们并不会使用默认的index动作,所以我们可以从actions.class.php文件中移除executeIndex()办法,并且从templates/目录中删除indexSuccess.php文件.

除了命令行,Symfony还提供了其他的办法来初始化一个模块.其中一个办法就是手动来创建目录与文件.在许多情况下,一个模块的动作与模板就意味着操作一个给定数据表的数据.因为创建,获取,更新,以及从一个数据表中删除数据记录的必须代码通常都是相同的,Symfony提供了一个名为框架的机制来我们生成这些代码.我们后续会继续介绍.PHP应用

添加一个页面PHP应用

在Symfony中,页面后面的逻辑存储在动作中,而表面则是在模板中.没有逻辑的页面仍然需要一个空的动作.PHP应用

添加一个动作PHP应用

"Hello,world!"页面则会通过一个myAction的动作进行拜访.要创建这个动作,只需要在mymoduleActions类中添加一个executeMyAction方法,如下所示：
PHP应用

代码如下:
<?php
 class mymoduleActions extends sfActions
 {
   public function executeMyAction()
     {
     }
 }

动作办法的名字总是execute'Xxx'()的形式,其中名字的第二部分是动作的名字,并且第一个字母大写.PHP应用

现在我们可以哀求下面的URL：
http://localhost/myapp_dev.php/mymodule/myActionPHP应用

Symfony将会抱怨丢失了myActionSuccess.php模板.这是正常的.在Symfony中,一个页面通常是由一个动和与一个模板组成的.PHP应用

URL是响应的一部分PHP应用

Symfony包含一个路由系统允许我们在实际的动作名与需要调用的URL格式之间有一个完整的分隔.这允许自定义URL的自定义格式,就如同他是响应的一部分.我们不再为文件的结构或是哀求的参数据限制,一个动作的URL看起来就我们所希望的解析.例如,到一个名为article模块的索引动作调用通常如下面的样子：
http://localhost/myapp_dev.php/article/index?id=123PHP应用

这个URL由一个数据获取一篇指定的文章.但是URL可以通过在routingyml配置文件中作一些小的改动而以一种完全不同的方式进行编写：
http://localhost/articles/europe/france/finance.htmlPHP应用

这样的URL不仅对于搜索引擎友好的,他对于用户来说也是十分重要的,这样用户就可以将地址栏作为一个伪码命令来自定义查询,例如下面的例子：
http://localhost/articles/tagged/finance+france+euroPHP应用

Symfony知道如何为用户解析并生成URL.路由系统会自动从一个简洁URL中脱去所哀求的参数,并使其为动作可用.他同时也会格式化响应中所包含的超链接,从而使其看起来更为简洁.我们将会在第九章了解这个特性的更多内容.PHP应用

总之,这就意味着我们命名程序的动作的方式不应受到调用他们的URL的样子的影响,而是受程序中动作的函数控制.一个动作的名了解释了动作实际所做的内容,而且通常为不定式格式中的一个动词(例如show,list,edit).动作的名字可以做到对于终端用户完全不可见,从而不必担心使用显式的动作名.我们可以有效的利用代码注释来解释我们的函数功能,从而使代码更读.PHP应用

添加一个模板PHP应用

动作需要一个模板来进行封装.一个模板就是位于一个模块的templates/目录的一个文件,通常是以动作和动作的词尾来进行命名的.默认的动作词尾为"success",所以为myAction动作所创建的模板文件应命名为myActionSuccess.php.PHP应用

模板只包含表现代码,所以在其中要包含尽可有少的PHP代码.实际上,一个显示"Hello,world!"的页面只有一行的代码的模板.
PHP应用

代码如下:
<p>Hello, world!</p>

如果我们需要在模板中运行一些PHP代码,我们应避免使用下面所列的通常的PHP语法.相反,应使用另一种PHP语法来编写我们的模板,从而使得代码对于非PHP程序来说更易于理解.不仅最终代码是正确的,而且有助于我们在动作中保持复杂的PHP代码,因为只有控制语句有对应代码.PHP应用

通常的PHP语法如下：
PHP应用

代码如下:
<p>Hello, world!</p>
<?php
 
 if ($test)
 {
   echo "<p>".time()."</p>";
 }
   
?>

替代的PHP语法如下：
PHP应用

代码如下:
<p>Hello, world!</p>
<?php if ($test): ?>
<p><?php echo time(); ?></p>
<?php endif; ?>

 
由动作向模板传递信息

动作的工作是要完成所有复杂的计算,数据读取以及测试,并且设置要输出或是测试的模板变量.Symfony使得动作类的属性在全局名字空间中为模板可用.下面显示如何由动作向模板传递信息.PHP应用

在动作中设置动作属性从而使其为模板可用：
PHP应用

代码如下:
<?php
 
 class mymoduleActions extends sfActions
 {
   public function executeMyAction()
     {
         $today = getdate();
     $this->hour = $today['hours'];
     }
 }

模板直接拜访动作属性：
PHP应用

代码如下:
<p>Hello, world!</p>
<?php if ($hour >= 18): ?>
<p>Or should I say good evening? It's already <?php echo $hour ?>.</p>
<?php endif; ?>

模板已经可以访问一些数据,而不需要在动作中设置任何变量.每一个模板通常可以调用$sf_context,$sf_request,$sf_params,$sf_user对象的方法.他们包含与当前内容,哀求,哀求参数以及会话相关的数据.我们很快就会学到他们的用法.PHP应用

使用表单向用户收集信息PHP应用

表单是向用户收集信息的一个好办法.使用HTML编写表单以及表单元素有时是相当麻烦的,尤其是当我们希望适用于XTHML时更是如此.我们可以用通常的方式在Symfony模板中包含表单元素,如下面所示,但是Symfony提供了帮助器从而使得这个任务更为简单.PHP应用

模板可以包含通常的HTML代码：
PHP应用

代码如下:
<p>Hello, world!</p>
<?php if ($hour >= 18): ?>
<p>Or should I say good evening? It's already <?php echo $hour ?>.</p>
<?php endif; ?>
<form method="post" target="/myapp_dev.php/mymodule/anotherAction">
  <label for="name">What is your name?</label>
  <input type="text" name="name" id="name" value="" />
  <input type="submit" value="Ok" />
</form>

一个赞助器是用在模板中的由Symfony定义的PHP函数.他输出HTML代码,并且比我们自己编写实际的HTML代码要快速得多.使用Symfony赞助器,我们用下面的代码得到的输出结果与上面通常的HTML代码相同：
PHP应用

代码如下:
<p>Hello, world!</p>
<?php if ($hour >= 18): ?>
<p>Or should I say good evening? It's already <?php echo $hour ?>.</p>
<?php endif; ?>
<?php echo form_tag('mymodule/anotherAction') ?>
  <?php echo label_for('name', 'What is your name?') ?>
  <?php echo input_tag('name') ?>
  <?php echo submit_tag('Ok') ?>
</form>

如果在上面的代码中,我们认为使用赞助器的版本并不会比编写HTML代码快,那么我们可以考虑一下下面的情况：
PHP应用

代码如下:
<?php
     $card_list = array(
       'VISA' => 'Visa',
       'MAST' => 'MasterCard',
       'AMEX' => 'American Express',
       'DISC' => 'Discover');
     echo select_tag('cc_type', options_for_select($card_list, 'AMEX'));
?>

这会得到下面的HTML输出结果：
PHP应用

代码如下:
<select name="cc_type" id="cc_type">
  <option value="VISA">Visa</option>
  <option value="MAST">MasterCard</option>
  <option value="AMEX" selected="selected">American Express</option>
  <option value="DISC">Discover</option>
</select>

在模板中使用的赞助器的好处就在于加快了编码的速度,代码的清晰与简洁.而代价就是我们需要花费时进行学习.所以我们可以在模板中不使用Symfony赞助器,并且以我们通常的方式来编写代码,但是这会是一个巨大的损失.PHP应用

注意,短开放标记的用法(<?=,等同于<?php echo)并不推荐在专业的web程序中使用,因为我们的web服务器也许会理解多个脚本语言,从而会使其变得迷惑.另外,短开放标记并不会与默认的PHP配置进行工作,而且需要修改服务来激活.最后,当我们必须处理XML与验证时,他会出错,因为<?在XML中有着特殊的意义.PHP应用

表单处理有专门的一章进行讨论,因为Symfony提供了许多工具,绝大数的赞助器,来使其简单.我们将会在第10章了解到关于赞助器更多的内容.PHP应用

链接到另一个动作PHP应用

我们现在已经知道在动作名字与需要调用的URL之间有一个分离.所以我们使用下面的方式来创建到另一个动作的链接时,他只会工作在默认的路由系统中.如果我们以后决定改变URL的样子,那么我们就需要查看所有的模板来改变超链接.PHP应用

超链接,通常的办法：
PHP应用

代码如下:
<a href="/myapp_dev.php/mymodule/anotherAction?name=anonymous">
  I never say my name
</a>

要避免这样的麻烦,我们应总是使用link_to()赞助器来我们的程序动作创建超链接.下面的例子演示了超链接赞助器的用法.PHP应用

link_to()赞助器：
PHP应用

代码如下:
<p>Hello, world!</p>
<?php if ($hour >= 18): ?>
<p>Or should I say good evening? It's already <?php echo $hour ?>.</p>
<?php endif; ?>
<?php echo form_tag('mymodule/anotherAction') ?>
  <?php echo label_for('name', 'What is your name?') ?>
  <?php echo input_tag('name') ?>
  <?php echo submit_tag('Ok') ?>
  <?php echo link_to('I never say my name','mymodule/anotherAction?name=anonymous') ?>
</form>

生成的HTML与前面的相同,所不同的就在于当我们改变我们的路由规则时,所有的模板都会正确工作,并且重新格式化URL.PHP应用

link_to()赞助器,就像其他的赞助器,会接受特定选项的额外参数和额外的标签属性.下面的例子显示了一个可选参数以及生成的HTML.选项参数或者是一个相关的数组或者是由空格分隔的显示key=value的简单字符串.PHP应用

大多数赞助器接收一个可选参数：
PHP应用

代码如下:
// Option argument as an associative array
<?php echo link_to('I never say my name', 'mymodule/anotherAction?name=anonymous',
  array(
      'class'    => 'special_link',
          'confirm'  => 'Are you sure?',
          'absolute' => true
)) ?>
   
// Option argument as a string
<?php echo link_to('I never say my name', 'mymodule/anotherAction?name=anonymous',
  'class=special_link confirm=Are you sure? absolute=true') ?>
         
// Both calls output the same
=> <a class="special_link" onclick="return confirm('Are you sure?');"
    href="http://localhost/myapp_dev.php/mymodule/anotherAction/name/anonymous">
    I never say my name</a>

任何时候我们使用一个Symfony赞助器来输出一个HTML标记时,我们可以在可选参数中插入额外的标记属性.我们可以使用HTML 4.0的方式来编写这样的属性,而Symfony将会以更简洁的格式进行输出.这也就是为什么赞助器会比HTML更容易编写的原因.PHP应用

因为他需要一个额外的分析与转换,字符串语法比数组语法要慢一些.PHP应用

与表单赞助器相类似,链接赞助器有更多的数量和选项.PHP应用

由哀求得到信息PHP应用

无论用户通过表单发送信息(通常以POST哀求的方式)还是通过URL(GET哀求),我们可以通过带有sfActions对象的getRequestParameter()方法的动作来获取数据.下面的例子显示如何在anotherAction中得到name参数的值.PHP应用

在动作中由哀求参数得到数据：
PHP应用

代码如下:
<?php
 
class mymoduleActions extends sfActions
{
  ...
 
  public function executeAnotherAction()
  {
    $this->name = $this->getRequestParameter('name');
  }
}

如果数据的处理是简单的,我们甚至并不需要使用动作来得到哀求参数.模板可以访问一个名为$sf_params的对象,他提供了get()方法来得到哀求参数,就如同动作中的getRequestParameter()方法.PHP应用

如果executeAnotherAction()办法是空的,下面的例子显示了anotherActionSuccess.php模板文件如何得到同样的name参数.PHP应用

在模板中直接由哀求参数得到数据：
PHP应用

代码如下:
<p>Hello, <?php echo $sf_params->get('name') ?>!</p>

那么为什么不使用$_POST,$_GET或是$_REQUEST变量呢?因为我们的URL将会不同的方式进行格式化(http://localhost/articles/europe/france/finance.html),这样通常的PHP变量就会再起作用,并且只有路由系统可以得到哀求参数.而我们希望添加输入过滤来阻止恶意代码注入,而这只有当我们将所有的哀求参数保存在一个简洁的参数装配器中才可能.PHP应用

$sf_params对象比仅提供一个与数组等同的方法要强大得多.例如,如果我们只是希望检测一个哀求参数是否存在,我们可以简单的使用$sf_params->has()方法,而不使用get()测试实际的值.PHP应用

在模板中测试哀求参数的存在：
PHP应用

代码如下:
<?php if ($sf_params->has('name')): ?>
  <p>Hello, <?php echo $sf_params->get('name') ?>!</p>
<?php else: ?>
  <p>Hello, John Doe!</p>
<?php endif; ?>

我们已经猜到了,这可以在单一的代码行中编写.与Symfony中大多数的获取方法一样,动作中的getRequestParameter()方法与模板中的$sf_params->get()(实际上调用同一个对象的相同主法)方法接受第二个参数：如果没有提供哀求参数则使用默认值：
PHP应用

代码如下:
<p>Hello, <?php echo $sf_params->get('name', 'John Doe') ?>!</p>

总结PHP应用

在Symfony中,页面是由一个动作(actions/actions.class.php文件中以execute为前缀的一个方法)和一个模板(templates/目录下的一个文件,通常以Success.php结尾)组成的.他们通地在程序中的函数组织在一个模块中.编写模板是由帮助器来完成的,而帮助器则是由Symfony提供的返回HTML代码的函数.而我们需要将URL看作响应的一部分,而URL在需要可以格式化,所以我们应避免在动作命名中使用到URL的直接引用或者是哀求参数检索.PHP应用

一旦我们知道了这些基本原则,我们就可以使用Symfony来编写一个完整的Web程序了.但是我们的路还有很长,因为我们在程序开发过程需要处理的每一个任务由一些Symfony特性来完成的.PHP应用

希望本文所述对大家的symfony框架程序设计有所赞助.PHP应用

欢迎参与《PHP实战：Symfony页面的基本创建实例详解》讨论，分享您的想法，维易PHP学院为您提供专业教程。

转载请注明本页网址：
http://www.vephp.com/jiaocheng/12529.html


    标签：  




同类教程排行


特辑教程