Les vues sont un élément clé de toute application MVC, et l'application CodeIgniter ne fait pas exception. Aujourd'hui, nous allons apprendre ce que sont les vues et comment les utiliser pour créer des solutions modèles pour vos projets CodeIgniter.
La première partie de ce didacticiel présentera aux débutants CodeIgniter ce que sont les vues et comment les utiliser dans une application typique. La seconde moitié discute des motivations pour trouver une solution de modèle et guide le lecteur à travers les étapes nécessaires pour créer une bibliothèque de modèles simple mais efficace.
Si vous souhaitez en faire plus avec CodeIgniter, consultez la gamme de plugins CodeIgniter et de scripts de code sur Envato Market.
Les vues sont des fichiers spéciaux dans CodeIgniter utilisés pour stocker le balisage pour la sortie de l'application, généralement constitué de HTML et de simple balisage PHP.
"Une vue n'est qu'une page Web ou un fragment de page, comme un en-tête, un pied de page, une barre latérale, etc. En fait, les vues ont la possibilité d'être intégrées dans d'autres vues (dans d'autres vues, etc.) si vous en avez besoin de manière hiérarchique. Tapez du système. »
Les vues sont chargées à partir des méthodes du contrôleur et le contenu de la vue est ensuite affiché dans le navigateur.
Pour charger (et afficher) des vues dans CodeIgniter, nous utilisons la bibliothèque Loader intégrée.
$this->load->view('hello_world', $data, true/false);
Cette ligne de code indiquera à CodeIgniter d'être sur application/views
文件夹中查找 hello_world.php
et affichera le contenu de ce fichier dans le navigateur.
Veuillez noter que CodeIgniter vous permet d'exclure le suffixe .php, économisant ainsi certaines frappes lors de la saisie du nom du fichier de vue à charger.
Le deuxième paramètre $data
est facultatif et prend un tableau ou un objet associatif. Ce tableau/objet est utilisé pour transmettre des données au fichier de vue afin qu'elles puissent être utilisées ou référencées dans la vue.
Le dernier paramètre optionnel détermine si le contenu de la vue est affiché dans la fenêtre du navigateur ou renvoyé sous forme de chaîne. Ce paramètre a la valeur par défaut false, ce qui affiche le contenu dans le navigateur. Nous verrons plus loin dans ce tutoriel comment utiliser ce paramètre lors de la création de solutions modèles.
Pour configurer notre première vue, créez un nouveau fichier sur application/views
中创建一个名为 hello_world.php
et écrivez-y le code HTML simple suivant :
<!DOCTYPE html> <html> <head> <title>Hello World!</title> </head> <body> <p> Hello world! </p> </body> </html>
Maintenant, pour afficher cette vue dans le navigateur, elle doit être chargée dans la méthode du contrôleur en utilisant la méthode ci-dessus.
Créons donc un nouveau fichier de contrôleur sur application/controllers
中创建一个名为 hello_world.php
et mettons-y le code suivant. À partir de ce contrôleur, nous chargerons la vue nouvellement créée.
<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed'); class Hello_world extends CI_Controller { public function index() { $this->load->view('hello_world'); } }
Pointez votre navigateur vers le HTML dans http://your-ci-install.com/index.php/
现在将导致 application/views/hello_world.php
pour obtenir le résultat dans votre navigateur. Vous avez chargé la vue avec succès !
Diviser vos vues en plusieurs fichiers peut faciliter la maintenance de votre site et réduire le risque de duplication de code.
Afficher une seule vue est acceptable, mais vous souhaiterez peut-être diviser la sortie en plusieurs fichiers différents, tels que les vues En-tête, Contenu et Pied de page.
Appelez simplement la méthode $this->load->view()
plusieurs fois pour charger plusieurs vues. CodeIgniter joint ensuite le contenu de la vue avant de l'afficher dans le navigateur.
dans les premières lignes du fichier application/views
中创建一个名为 header.php
的新文件,并剪切并粘贴原始 hello_world.php
.
<!DOCTYPE html> <html> <head> <title>Hello World!</title> </head> <body>
De même, déplacez-vous dans les deux dernières lignes de application/views
中创建另一个名为 footer.php
的文件,并将 hello_world.php
.
</body> </html>
Cela fait que le fichier de vue hello_world.php
contient uniquement le contenu de notre page.
<p> Hello world! </p>
Maintenant, pour afficher à nouveau la page, nous devons charger les trois vues (header.php, hello_world.php, footer.php) séquentiellement dans le contrôleur.
Rouvrez application/controllers/hello_world.php
et ajoutez de nouveaux application/controllers/hello_world.php
并在现有调用的上方和下方添加新的 $this->load->view()
appels au-dessus et en dessous des appels existants.
<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed'); class Hello_world extends CI_Controller { public function index() { $this->load->view('header'); $this->load->view('hello_world'); $this->load->view('footer'); } }
Étant donné que les vues d'en-tête et de pied de page sont désormais distinctes de la vue hello_world
, cela signifie qu'elles peuvent être utilisées conjointement avec n'importe quelle autre vue du site. Cela signifie que le code des fichiers d'en-tête et de pied de page n'a pas besoin d'être copié dans d'autres vues du projet nécessitant ce code.
Évidemment, c'est un énorme avantage, puisque toute modification du code HTML ou du contenu de la vue (par exemple, l'ajout d'une nouvelle feuille de style à l'en-tête) ne peut être effectuée que sur un seul fichier, pas sur tous les fichiers !
现在,我们将研究从控制器传递数据,以便可以在视图内使用或输出它们。
为此,我们将传递一个关联数组 $data
作为 $this->load->view()
调用中的第二个参数。
该数组的值将在加载的视图中作为变量进行访问,由各自的键命名。
$data = array( 'title' => 'Hello World!', 'content' => 'This is the content', 'posts' => array('Post 1', 'Post 2', 'Post 3') ); $this->load->view('hello_world', $data);
上面的代码将为变量 $title 赋予值“Hello World!”在 hello_world
视图内。
一旦我们将数据传递到视图文件,就可以按照通常的方式使用变量。
通常,视图文件将使用传递的数据来:
我将通过快速示例来说明如何执行每个操作。
要显示变量的内容,请使用简单且熟悉的 echo 语句:
<h1><?php echo $title; ?></h1>
循环遍历数组或对象是视图文件中的常见任务,可以使用 foreach 循环来实现:
<ul> <?php foreach($posts as $post) { ?> <li><?php echo $post; ?></li> <?php } ?> </ul>
可以在视图文件中使用简单的条件语句来稍微改变输出,具体取决于传递的数据。
一般来说,您希望尽量减少视图中条件语句的使用,因为过度使用可能会导致包含“业务逻辑”的复杂视图文件。将视图拆分为不同的文件,并决定在控制器中显示哪个文件是更可取的。
<?php if ( $logged_in ) { ?> <p><?php echo 'Welcome '.$user_name; ?></p> <?php } else { ?> <p>Please login</p> <?php } ?>
上面的示例将显示“欢迎”消息,或要求用户登录的请求,具体取决于 $logged_in
的值(true/false)。
我们已经了解了如何将视图拆分为单独的较小文件可以帮助组织和减少 CodeIgniter 项目中的文件数量,但现在每个显示页面的实例都需要进行多个加载视图调用。
假设您有单独的页眉和页脚视图,它们用于形成模板。项目中您希望使用此模板加载和显示页面的每个实例,都必须调用三个视图加载。这不仅会使您的控制器变得混乱,还会导致大量重复代码 - 这正是我们希望通过拆分文件来摆脱的事情。
如果您现在想向此模板添加额外的标记,例如侧边栏菜单。它可以放在标题视图中,但更适合放在自己的单独视图中。将这个新视图添加到现有模板意味着要遍历视图加载的每个实例,然后添加另一个实例。这可能会很快变得混乱。
我们需要一种方法,能够将显示单个页面内容的视图文件嵌入模板内,而无需重复代码,并且允许轻松高效地对模板进行修改。
以下步骤将指导您创建一个简单的 CodeIgniter 库来满足这些需求,以及:
一旦库被编写并放入我们的 CodeIgniter 工具带中,我们将能够显示一个模板化页面,如下所示:
$this->template->load('template_name', 'body_view');
好多了!
我们的模板解决方案将使用包含模板完整标记的视图文件,以及要嵌入其中的另一个视图文件(包含页面内容)的占位符。
占位符实际上只是一个名为 $body
的变量。当使用我们的库加载模板化视图时,相应的正文视图文件的内容将被分配给此 $body
,将视图嵌入到模板中。
我们希望为要存放的视图文件强制执行一个合理且可预测的目录系统,以便我们的视图:
我们的目录系统还允许库巧妙地确定在哪里查找视图文件,从而减少加载模板化视图所需的代码量。
在 application/views
目录中创建一个新文件夹,并将其命名为 templates
。该文件夹将保存不同的模板视图。
CodeIgniter 中的库只是 PHP 类,并且像视图一样加载到控制器中。
$this->load->library('class_name');
您在 CodeIgniter 项目中使用的自定义库存储在 application/libraries
文件夹中。要开始编写我们的模板库,请在此文件夹中创建一个名为 Template.php
的新文件,并将以下代码放入:
<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed'); class Template { var $ci; function __construct() { $this->ci =& get_instance(); } }
上面的代码定义了一个名为 Template 的新类或库,以及其中的 __construct()
方法。
此方法将 CodeIgniter 超级对象分配给 $ci
类变量,从而通过在通常的方法调用中将 $this
替换为 $this->ci
来允许使用 CodeIgniter 的所有资源。
当CodeIgniter框架加载该库时,会自动调用__construct()
方法。
现在我们将编写实际加载模板视图的方法。我们希望向此函数传递最多三个参数:
调用此方法的结果将是在浏览器中显示模板视图,并嵌入其中的正文视图(如果提供了)。
在 __construct()
方法下面,放置以下代码:
function load($tpl_view, $body_view = null, $data = null) { if ( ! is_null( $body_view ) ) { if ( file_exists( APPPATH.'views/'.$tpl_view.'/'.$body_view ) ) { $body_view_path = $tpl_view.'/'.$body_view; } else if ( file_exists( APPPATH.'views/'.$tpl_view.'/'.$body_view.'.php' ) ) { $body_view_path = $tpl_view.'/'.$body_view.'.php'; } else if ( file_exists( APPPATH.'views/'.$body_view ) ) { $body_view_path = $body_view; } else if ( file_exists( APPPATH.'views/'.$body_view.'.php' ) ) { $body_view_path = $body_view.'.php'; } else { show_error('Unable to load the requested file: ' . $tpl_name.'/'.$view_name.'.php'); } $body = $this->ci->load->view($body_view_path, $data, TRUE); if ( is_null($data) ) { $data = array('body' => $body); } else if ( is_array($data) ) { $data['body'] = $body; } else if ( is_object($data) ) { $data->body = $body; } } $this->ci->load->view('templates/'.$tpl_view, $data); }
上面的代码首先检查 $body_view
参数是否已提供给该方法。该变量将保存要用作模板视图中的正文的视图的名称。
if ( ! is_null( $body_view ) )
如果提供了该参数,则会进行一系列 file_exists 检查,以尝试在目录系统中找到视图文件。
if ( file_exists( APPPATH.'views/'.$tpl_view.'/'.$body_view ) ) { $body_view_path = $tpl_view.'/'.$body_view; } else if ( file_exists( APPPATH.'views/'.$tpl_view.'/'.$body_view.'.php' ) ) { $body_view_path = $tpl_view.'/'.$body_view.'.php'; }
该代码首先尝试在 application/views
文件夹中与模板同名的文件夹内找到视图文件。
如果项目的各个部分与其他部分截然不同并且使用不同的模板,这非常有用。在这些情况下,将这些视图文件分组在一起是有意义的。
例如,许多网站为不同的部分(例如博客)显示不同的模板。在我们的系统中,博客视图文件可以放置在 application/views/blog
文件夹中,将它们与主站点视图分开。
如果无法在此文件夹中找到视图文件,则将 .php
附加到文件名末尾,并再次进行检查。这只是为了像本地 $this->load->view()
调用一样排除 .php
。
如果仍然找不到该文件,则会进一步检查其位置。
else if ( file_exists( APPPATH.'views/'.$body_view ) ) { $body_view_path = $body_view; } else if ( file_exists( APPPATH.'views/'.$body_view.'.php' ) ) { $body_view_path = $body_view.'.php'; } else { show_error('Unable to load the requested file: ' . $tpl_name.'/'.$view_name.'.php'); }
这次,代码检查视图文件是否位于 application/views
文件夹内,如果找不到,则追加 .php
并再次检查。
如果文件位于这些位置之一,则将路径分配给 $body_view_path
,否则使用 CodeIgniter 内置的 show_error()
函数会抛出错误消息,并终止脚本。
如果成功找到正文视图文件,则内容将分配给 $body
变量。
$body = $this->ci->load->view($body_view_path, $data, TRUE);
我们将 $data
参数(如果未提供则为 null)传递给视图加载调用,并将第三个参数设置为 true 以将视图的输出作为字符串返回。
我们现在将这个 $body
变量添加到 $data
中的数据列表中,以便在加载时可以将其嵌入到模板视图中。
if ( is_null($data) ) { $data = array('body' => $body); } else if ( is_array($data) ) { $data['body'] = $body; } else if ( is_object($data) ) { $data->body = $body; }
如果 $data
未提供给 load()
调用,则 $data
会被分配到键 body 下包含 $body
的数组。如果提供了参数,则将 $body
添加到列表中,方法是将其分配给数组键或对象属性,两者也都命名为 body。
$body
变量现在可以在模板视图文件中用作嵌入视图的占位符。
我们方法的最后一行从 application/views/templates
文件夹加载模板视图文件,并在第二个参数中传递 $data
变量。
$this->ci->load->view('templates/'.$tpl_name, $data);
就是这样!该库现在可以投入使用了。
要开始使用我们的库,让我们在 application/views/templates
中创建一个名为 default.php
的模板视图,并将以下 HTML/PHP 放入其中:
<!DOCTYPE html> <html> <head> <title><?php echo $title; ?></title> </head> <body> <h1>Default template</h1> <div class="wrapper"> <?php echo $body; ?> </div> </body> </html>
在此模板中,我们引用两个变量,$title
和 $body
。
回想一下,在我们的模板文件中,$body
用作嵌入视图的占位符。
我们现在将制作另一个视图嵌入到该模板中。在 application/views/
中创建一个名为 content.php
的新文件,并将以下简单的 HTML 放入其中:
<p> Hello world! </p>
我们现在准备从控制器内加载模板化页面视图。
在任何控制器方法内,放置以下代码以在 default
模板内显示 content
视图。
$data = array( 'title' => 'Title goes here', ); $this->load->library('template'); $this->template->load('default', 'content', $data);
注意:必须先加载该库,然后才能调用 load
方法。为了避免每次需要显示模板视图时加载库,
通过将类添加到 application/config/autoload.php
中的库数组来自动加载该类。
如果您希望在模板中嵌入字符串而不是视图文件,只需使用键 body
将字符串分配给 $data
数组,并传递 null
作为加载调用中的第二个参数。
$data = array( 'title' => 'Title goes here', 'body' => 'The string to be embedded here!' ); $this->template->load('default', null, $data);
我发现按控制器甚至它们所属的方法将视图文件分组到文件夹中确实有助于使我的视图井然有序且易于查找。
以这种方式组织视图会导致目录结构紧密遵循 controller/method
的 URL 架构。
例如,假设您的项目有一个名为 Members
的控制器,包含方法 list
。
list
视图文件的适当位置应位于 application/views/members
或 application/views/members/list
(如果此方法加载多个视图)。
然后可以使用我们的库通过以下代码将该视图嵌入到模板中:
$this->template->load('template_name', 'members/list');
本教程中讨论的模板解决方案只是在 CodeIgniter 中实现模板的众多不同方法之一。
希望您现在应该知道什么是视图,以及如何在您的 CodeIgniter 项目中有效且高效地使用它们。
本教程中讨论的模板解决方案只是在 CodeIgniter 中实现模板的众多不同方法之一。有多种不同的方法,我鼓励读者研究其他方法并确定哪种方法最适合您的项目。
如果您对本教程有任何意见或疑问,或者对不同模板解决方案有任何见解,请在下面发表评论!感谢您的阅读。
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!