Maison >développement back-end >tutoriel php >Utilisation de base du framework Yii en PHP
Cet article présente principalement l'utilisation de base du framework Yii en PHP. Les amis intéressés peuvent s'y référer. J'espère qu'il sera utile à tout le monde.
Dans le code généré automatiquement par Yii, on peut toujours voir CGridView dans l'interface d'administration. Il s'agit d'un contrôle de table très utile pour afficher les données, s'il est bien utilisé, il peut accélérer considérablement la progression du développement. Explorons l'utilisation de base de CGridView :
drop table if exists `tbl_user`; CREATE TABLE tbl_user ( `user_id` INTEGER NOT NULL AUTO_INCREMENT comment '主键', `username` VARCHAR(128) NOT NULL comment '用户名', `nickname` VARCHAR(128) NOT NULL comment '昵称', `password` VARCHAR(128) NOT NULL comment '密码', `email` VARCHAR(128) NOT NULL comment '邮箱', `is_delete` tinyint not null default 0 comment '删除标志', unique key(`username`), primary key (`user_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 comment='用户表'; drop table if exists `tbl_post`; CREATE TABLE tbl_post ( `post_id` INTEGER NOT NULL AUTO_INCREMENT comment '主键', `title` VARCHAR(128) NOT NULL comment '标题', `content` TEXT NOT NULL comment '文章内容', `tags` TEXT comment '标签', `status` INTEGER NOT NULL comment '状态,0 = 草稿,1 = 审核通过,-1 = 审核不通过,2 = 发布', `create_time` INTEGER comment '创建时间', `update_time` INTEGER comment '更新时间', `author_id` INTEGER NOT NULL comment '作者', `is_delete` tinyint not null default 0 comment '删除标志', CONSTRAINT `post_ibfk_1` FOREIGN KEY (author_id) REFERENCES tbl_user (`user_id`) ON DELETE CASCADE ON UPDATE RESTRICT, primary key (`post_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8 comment='日志表';
Deux tables, l'une stockant les informations sur l'auteur et l'autre stockant les journaux, où les journaux ont une clé étrangère associée à l'utilisateur. Le champ is_delete dans les deux tables indique si l'enregistrement a été supprimé, 0 signifie non supprimé et 1 signifie supprimé. Jetons un coup d'œil à la méthode de relation de la classe Post générée avec gii :
/** * @return array relational rules. */ public function relations() { // NOTE: you may need to adjust the relation name and the related // class name for the relations automatically generated below. return array( 'comments' => array(self::HAS_MANY, 'Comment', 'post_id'), 'author' => array(self::BELONGS_TO, 'User', 'author_id'), ); }
La clé étrangère auteur existe sous la forme d'une relation BELONGS_TO, ce qui est conforme à nos attentes.
Cela dit, jetez un œil au code de CGridView dans admin.php dans le message généré automatiquement :
<?php $this->widget('zii.widgets.grid.CGridView', array( 'id'=>'post-grid', 'dataProvider'=>$model->search(), 'filter'=>$model, 'columns'=>array( 'post_id', 'title', 'content', 'tags', 'status', 'create_time', 'update_time', 'author_id', 'is_delete', array( 'class'=>'CButtonColumn', ), ), )); ?>
Regardez ! Bien que nous n’ayons rien écrit, il s’agit de l’utilisation la plus basique de ce contrôle. dataProvider sont les données fournies par la fonction de recherche dans le modèle, filtre... Je ne vois pas le rôle ici pour le moment. Columns contrôle chaque colonne affichée. Le dernier élément de CButtonColumn nous montre trois boutons, à savoir View Update et. supprimer.
Ensuite, nous allons le transformer petit à petit.
Utilisez CGridView pour afficher le formulaire de données que nous voulons vraiment : Souvent, les éléments de la base de données ne conviennent pas pour être affichés directement. à l'utilisateur. Nous en avons besoin. Il n'est adapté à la lecture qu'après un certain traitement. Mais sans modification ici, CGridView ne présentera que la valeur de la base de données inchangée, nous devons donc la modifier dans le champ correspondant. Par exemple, dans le champ is_delete, 0 et 1 sont stockés dans la base de données, mais ce n'est pas très bon à lire ici. Nous devrions le changer en 1 pour afficher « oui » et 0 pour afficher « non ». Jetez un œil au code ci-dessous. Nous utilisons un tableau. Les deux clés sont name et value. Le nom correspond aux champs appartenant au modèle, et la valeur correspond aux données que vous souhaitez afficher. code exécuté. En voyant cela, pensez-vous que nous pouvons faire beaucoup avec cette valeur ? Certains étudiants peuvent se demander : si le code que je veux exécuter est très long, est-il entièrement écrit en valeur ? . . . J'ai dit camarade de classe, n'écrirais-tu pas une fonction ailleurs et ne l'appellerais-tu pas ici ? ?
<?php $this->widget('zii.widgets.grid.CGridView', array( 'id'=>'post-grid', 'dataProvider'=>$model->search(), 'filter'=>$model, 'columns'=>array( 'post_id', 'title', 'content', 'tags', 'status', 'create_time', 'update_time', 'author_id', 'is_delete', array( 'name'=>'is_delete', 'value'=>'is_delete?"是":"否"' //value 是可以执行 php 语句的哦 ) array( 'class'=>'CButtonColumn', ), ), )); ?>
De plus, certaines options couramment utilisées peuvent être renseignées dans le tableau. Voici l'utilisation la plus courante (d'autres parties du code sont omises) :
array( 'name'=>'is_delete', 'value'=>'is_delete?"是":"否"' //value 是可以执行 php 语句的哦 'filter' => array(0=>'否',1=>'是'), //自己定义搜索过滤的方式,这里为 是 和 否 的下拉菜单 'htmlOptions'=>array('class'=>'delete'), //可以定义 html 选项,这里是定义了带一个 delete 的类 ),
Si nous utilisons le nom ci-dessus, il s'agit d'un champ existant dans le modèle. Si nous souhaitons afficher un nouveau contenu défini par nous-mêmes, utilisez header :
array( 'header'=>'备注', 'value'=> 'display your data' ),
pour ajouter CCheckBoxColumn : Parfois peut-être Nous aurons besoin d'une case à cocher pour sélectionner chaque ligne. A ce moment, nous pouvons ajouter une colonne et utiliser la classe CCheckBoxColumn :
<?php $this->widget('zii.widgets.grid.CGridView', array( 'id'=>'post-grid', 'dataProvider'=>$model->search(), 'filter'=>$model, 'columns'=>array( array( 'selectableRows' => 2, //允许多选,改为 0 时代表不允许修改,1 的话为单选 'class' => 'CCheckBoxColumn',//复选框 'headerHtmlOptions' => array('width'=>'18px'),//头部的 html 选项 'checkBoxHtmlOptions' => array('name' => 'myname','class'=>'myclass'), //复选框的 html 选项 ), 'post_id', 'title', 'content', 'tags', 'status', 'create_time', 'update_time', 'author_id', 'is_delete', array( 'name'=>'is_delete', 'value'=>'is_delete?"是":"否"', //value 是可以执行 php 语句的哦 'filter' => array(0=>'否',1=>'是'), //自己定义搜索过滤的方式,这里为 是 和 否 的下拉菜单 'htmlOptions'=>array('class'=>'delete'), //可以定义 html 选项,这里是定义了带一个 delete 的类 ), array( 'class'=>'CButtonColumn', ), ), ));
pour modifier la ButtonColumn : Notez que. chaque colonne de la liste Les trois dernières petites icônes de l'élément ? Bien sûr, si vous n’en avez pas besoin, supprimez-les directement. Mais que se passe-t-il si vous n’en voulez que quelques-uns ? Vous pouvez ajouter un paramètre de modèle :
array( 'class'=>'ButtonColumn', 'template'=>"{view} {update}", ),Vous pouvez également personnaliser le bouton :
array( 'class'=>'ButtonColumn', 'template'=>"{view} {update} {print}", 'buttons'=>array( 'print'=>array( 'label'=>'打印', 'url'=>'Yii::app()->controller->createUrl("print", array("id"=>$data->post_id))', 'options'=>array("target"=>"_blank"), ), ), ),
Déclencher Javascript lors du rafraîchissement : Si vous souhaitez déclencher après chaque search Certains Javascript et Yii proposent également cette option. Il vous suffit de l'écrire sous forme de fonction et de la définir aprèsAjaxUpdate. N'oubliez pas que ceci n'est appelé qu'une fois la requête ajax terminée. Si vous souhaitez l'appeler dès que la page est chargée, vous devez l'ajouter à la page. Javascript
$js = <<<_JS_ function(){ alert('The ajax finish'); } _JS_; $this->widget('zii.widgets.grid.CGridView', array( 'id'=>'post-grid', 'dataProvider'=>$model->search(), 'filter'=>$model, 'afterAjaxUpdate'=>$js, //看这里,ajax 之后调用的 javascript 在这里.... 'columns'=>array( array( 'selectableRows' => 2, //允许多选,改为 0 时代表不允许修改,1 的话为单选 'class' => 'CCheckBoxColumn',//复选框 'headerHtmlOptions' => array('width'=>'18px'), 'checkBoxHtmlOptions' => array('name' => 'myname','class'=>'myclass'), ), ....
Ajouter la recherche des champs associés dans le tableau associé : Tout d'abord, nous parlons uniquement de "un-à-plusieurs". " recherche associée ici. Tout d'abord, n'oubliez pas notre base de données, les étudiants qui ont oublié veuillez cliquer ici : Ici, vous pouvez voir qu'il y a une clé étrangère dans tbl_post associée à la table tbl_user pour trouver des informations pertinentes sur l'auteur. Après avoir construit la base de données, jetez un œil au modèle POST du code Yii que nous avons généré. La réalité à l'intérieur est la suivante (ignorez le commentaire) :
/** * @return array relational rules. */ public function relations() { // NOTE: you may need to adjust the relation name and the related // class name for the relations automatically generated below. return array( 'comments' => array(self::HAS_MANY, 'Comment', 'post_id'), 'author' => array(self::BELONGS_TO, 'User', 'author_id'), ); }Vous pouvez voir que les tables POST et USER peuvent. accessible via la clé d'auteur. Par exemple : $model->author->nickname, et voici la relation BELONGS_TO.
Cela dit, quels sont exactement nos besoins ? ....
淡定淡定,不就是改需求吗。忽略进度要求,我们研究一下究竟要做什么。
其实很简单的,不就是在 POST 的 admin 界面中增加一列作者名称,然后可以通过作者名的 模糊搜索 去找到对应日志吗?看看代码,要是通过 作者 id 去搜索不就简单了吗?不过这样确实不太友好...如果是展示作者名字而已不也是很简单吗?加一个 header 然后 value 是 $data->author->username, 问题是这样只能展示,不能进行搜索...哎,好苦恼。
淡定淡定,不就是多个搜索吗?来,让我告诉你怎么做。
首先,我们进入 POST 的 model,在一开始的地方添加一个属性:
class Post extends CActiveRecord { public $name; //添加一个 public 属性,代表作者名 然后改一下 Model 里面 search 的代码,改动部分都已经加了注释: public function search() { // @todo Please modify the following code to remove attributes that should not be searched. $criteria=new CDbCriteria; $criteria->with = array('author'); //添加了和 author 的渴求式加载 $criteria->compare('post_id',$this->post_id); $criteria->compare('title',$this->title,true); $criteria->compare('content',$this->content,true); $criteria->compare('tags',$this->tags,true); $criteria->compare('status',$this->status); $criteria->compare('create_time',$this->create_time); $criteria->compare('update_time',$this->update_time); $criteria->compare('author_id',$this->author_id); //这里添加了一个 compare, username 是 User 表的字段,$this->name 是我们添加的属性,true 为模糊搜索 $criteria->compare('username',$this->name,true); return new CActiveDataProvider($this, array( 'criteria'=>$criteria, )); }
然后在 view 里面,就是 post 文件夹的 admin.php ,CGridView 改为下面代码:
<?php $this->widget('zii.widgets.grid.CGridView', array( 'id'=>'post-grid', 'dataProvider'=>$model->search(), 'filter'=>$model, 'columns'=>array( 'post_id', 'title', 'content', 'tags', 'status', 'create_time', 'update_time', 'author_id', /*下面就是添加的代码啊*/ array( 'name'=>'作者名称', 'value'=>'$data->author->username', //定义展示的 value 值 'filter'=>CHtml::activeTextField($model,'name'), //添加搜索 filter ), array( 'class'=>'CButtonColumn', ), ), )); ?>
你是不是发现现在有了搜索框但是不起作用呢?哈哈,所以我们说文章要坚持看到最后。我们要做的最后一步,就是在 rule 里面,把 name 属性加入到安全搜索字段中,要不然会被 Yii 认为是不安全字段而过滤掉的。看,就在下面函数的最后一行,safe 前面多了个 name ....
public function rules() { // NOTE: you should only define rules for those attributes that // will receive user inputs. return array( array('title, content, status, author_id', 'required'), array('status, create_time, update_time, author_id', 'numerical', 'integerOnly'=>true), array('title', 'length', 'max'=>128), array('tags', 'safe'), // The following rule is used by search(). // @todo Please remove those attributes that should not be searched. array('post_id, title, content, tags, status, create_time, update_time, author_id, name', 'safe', 'on'=>'search'), ); }
总结:以上就是本篇文的全部内容,希望能对大家的学习有所帮助。
相关推荐:
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!