YII2项目常用技能知识总结
1、不通过日志获取AR执行的原生SQL语句和打印变量数据

  1. $query = User::find() ->select(['username'])->where(['id'=>[1,2,3,4])
  2. // get the AR raw sql in YII2
  3. $commandQuery = clone $query;
  4. echo $commandQuery->createCommand()->getRawSql();$users = $query->all();

打印变量数据可以这样写:

  1. //引用命名空间
  2. use yii\helpers\VarDumper;
  3. //使用
  4. VarDumper::dump($var);
  5. //使用2 第二个参数是数组的深度 第三个参数是是否显示代码高亮(默认不显示)
  6. VarDumper::dump($var, 10 ,true);

2、从数据库二维数组中返回一维数组并配合rules验证规则实现分类数据过滤。
普通返回表记录的二维数组

  1. Member::find()->select('userid')->asArray()->all();
  2. Array
  3. (
  4. [0] => Array
  5. (
  6. [userid] => 1
  7. )
  8. [1] => Array
  9. (
  10. [userid] => 2
  11. )
  12. [2] => Array
  13. (
  14. [userid] => 3
  15. )
  16. )

返回字段的一维数组

  1. Member::find()->select('userid')->asArray()->column();

或者:

  1. \yii\helpers\ArrayHelper::getColumn(Member::find()->all(), 'userid')
  2. Array
  3. (
  4. [0] => 1
  5. [1] => 2
  6. [2] => 3
  7. )

返回一维数组配合验证规则验证数据正确性,如分类catid正确分为只有1-4,但是在devTools打开修改catid为5,提交同样会到数据库,此时rules验证规则如下:

  1. ['catid', 'in', 'range' => category::find()->select('id')->asArray()->column()],
  2. ``
  3. 当然,这个也可以通过下面这样子写,一样的:
  4. ``
  5. ['catid', 'in', 'range' => \yii\helpers\ArrayHelper::getColumn(category::find()->all(), 'catid')],

这样就可以过滤不正确的分类数据了!
3、友好时间表示方法
之前一直使用自定义的友好时间函数。几天前发现万能的YII已经提供了友好时间访问,代码如下:

  1. Yii::$app->formatter->asRelativeTime('1447565922'); //2小时前

4、使用不同的响应类型或者自定义响应类型
有效的格式:

FORMAT_RAW
FORMAT_HTML
FORMAT_JSON
FORMAT_JSONP
FORMAT_XML
JSON响应

  1. public function actionIndex()
  2. {
  3. \Yii::$app->response->format = \yii\web\Response::FORMAT_JSON;
  4. $items = ['some', 'array', 'of', 'data' => ['associative', 'array']];
  5. return $items;
  6. }

返回:

  1. {
  2. "0": "some",
  3. "1": "array",
  4. "2": "of",
  5. "data": ["associative", "array"]
  6. }

自定义响应格式
让我们创建一个定制的响应格式。例子做点有趣和疯狂的事我返回PHP 数组。 首先,我们需要格式化程序本身。创建

  1. components/PhpArrayFormatter.php
  2. namespace app\components;
  3. use yii\helpers\VarDumper;
  4. use yii\web\ResponseFormatterInterface;
  5. class PhpArrayFormatter implements ResponseFormatterInterface
  6. {
  7. public function format($response)
  8. {
  9. $response->getHeaders()->set('Content-Type', 'text/php; charset=UTF-8');
  10. if ($response->data !== null) {
  11. $response->content = "data) . ";\n";
  12. }
  13. }
  14. }

组件配置:

  1. return [
  2. // ...
  3. 'components' => [
  4. // ...
  5. 'response' => [
  6. 'formatters' => [
  7. 'php' => 'app\components\PhpArrayFormatter',
  8. ],
  9. ],
  10. ],
  11. ];

现在是准备使用。在 controllers/SiteController 创建一个新的方法

  1. actionTest:
  2. public function actionTest()
  3. {
  4. Yii::$app->response->format = 'php';
  5. return [
  6. 'hello' => 'world!',
  7. ];
  8. }

返回如下:

  1. return [
  2. 'hello' => 'world!',
  3. ];

5、AR入库前时间通过在模型重写behaviors方法实现优雅入库方式。
如下:

  1. public function behaviors()
  2. {
  3. return [
  4. 'timestamp' => [
  5. 'class' => TimestampBehavior::className(),
  6. 'attributes' => [
  7. ActiveRecord::EVENT_BEFORE_INSERT => 'creation_time',
  8. ActiveRecord::EVENT_BEFORE_UPDATE => 'update_time',
  9. ],
  10. 'value' => function() { return date('U'); // unix timestamp },
  11. ],
  12. ];
  13. }

6、除配置组件记录不同级别日志外,也可以自定义在某个地方记录LOG日志

  1. use yii\log\Logger;
  2. \Yii::getLogger()->log('User has been created', Logger::LEVEL_INFO);

7、 ActiveForm类不让生成label标签

  1. //方法一,通过ActiveForm类
  2. $form->field($model, '字段名')->passwordInput(['maxlength' => true])->label(false) ?>
  3. //方法二,通过 HTML类
  4. Html::activeInput($type,$model,'字段名')
  5. Yii2给必填项加星,样式如下:
  6. div.required label:after {
  7. content: " *";
  8. color: red;
  9. }

8、Yii2 获取接口传过来的 JSON 数据:
接收get和post的数据很容易,那么接收json数据呢?!没关系,看这里:

  1. Yii::$app->request->rawBody;

9、座机和手机号码必须填写一个:

  1. public function rules()
  2. {
  3. return [
  4. [['telephone', 'mobile'], function ($attribute, $param) {//至少要一个
  5. if (empty($this->telephone) && empty($this->mobile)) {
  6. $this->addError($attribute, 'telephone/mobile至少要填一个');
  7. }
  8. }, 'skipOnEmpty' => false],
  9. ];
  10. }

10、where多条件查询示例:

  1. //and复杂示例:
  2. $time = time();
  3. Member::find()->where(['and', ['userid' => 1, 'company' =>'测试公司'], ['>', 'addtime', $time]]);
  4. //SELECT * FROM `member` WHERE ((`userid`=1) AND (`company`='测试公司')) AND (`addtime` > 1447587486)
  5. //and和or组合示例:
  6. $query = Member::find()->where(['and', ['>','userid',2], ['or', ['company' => '深圳市新民家具有限公司'], ['address' => '深圳']]]);
  7. //SELECT * FROM `member` WHERE (`userid` > 2) AND ((`company`='深圳市新民家具有限公司') OR (`address`='深圳'))

11、关于事务:
优雅的写法

  1. Yii::$app->db->transaction(function() {
  2. $order = new Order($customer);
  3. $order->save();
  4. });

这相当于下列冗长的代码:

  1. $transaction = Yii::$app->db->beginTransaction();
  2. try {
  3. $order = new Order($customer);
  4. $order->save();
  5. $transaction->commit();
  6. } catch (\Exception $e) {
  7. $transaction->rollBack();
  8. throw $e;
  9. }

12、rest风格API获取客户端提交的get和post的数组

  1. // post
  2. Yii::$app->request->bodyParams
  3. // get
  4. Yii::$app->request->queryParams;

13、一个控制器调用其他控制器action的方法:
方法一:
是经典的重写actions方法

  1. public function actions()
  2. {
  3. return [
  4. 'error' => [
  5. 'class' => 'yii\web\ErrorAction',
  6. ],
  7. 'captcha' => [
  8. 'class' => 'yii\captcha\CaptchaAction',
  9. 'fixedVerifyCode' => YII_ENV_TEST ? 'testme' : null,
  10. ],
  11. ];
  12. }

actions继承yii\base\Actions类,并重写父类的run方法。
方法二:
site控制器如下,访问MemberController控制器下面的index方法。

  1. class SiteController extends Controller
  2. {
  3. public function actionIndex(){
  4. Yii::$app->runAction('member/index', ['param'=>'123']);
  5. }
  6. }
  7. MemberController控制器如下:
  8. class MemberController extends Controller
  9. {
  10. public function actionIndex($param = '456'){
  11. echo "second Controller".$param;
  12. }
  13. }

访问:http://www.yii.dev/site/index.html
输出:second Controller123
14、点击下载,如下载安卓APK文件。

  1. public function actionDownload(){
  2. return \Yii::$app->response->setDownloadHeaders("http://xxx.com/apk/com.trade.activity.3.0.8.apk");
  3. //return \Yii::$app->response->sendFile("./com.trade.activity.3.0.8.apk");
  4. }

15、YII模块IP白名单设置,增加安全性

  1. $config['modules']['gii'] = [
  2. 'class' => 'yii\gii\Module',
  3. 'allowedIPs' => ['127.0.0.1', '::1','10.10.1.*'],
  4. ];
  5. $config['modules']['debug'] = [
  6. 'class' => 'yii\debug\Module',
  7. 'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.33.1'],
  8. ];

16、防止 SQL 和 Script 注入

  1. use yii\helpers\Html;
  2. use yii\helpers\HtmlPurifier;
  3. echo Html::encode($view_hello_str) //可以原样显示代码
  4. echo HtmlPurifier::process($view_hello_str) //可以过滤掉代码

17、验证某个ID值是否存在

  1. //之前一直用$model->findOne($id);exists()方法,资源节约,有没有?!
  2. public function validateAttribute($model, $attribute)
  3. {
  4. $value = $model->$attribute;
  5. if (!Status::find()->where(['id' => $value])->exists()) {
  6. $model->addError($attribute, $this->message);
  7. }
  8. }

18、批量查询
如查询并循环10000条数据。一次性拿1万条内存会有压力,通过批量查询,每次拿1000条,那么内存始终只有1000条的占有量。

  1. foreach(Member::find()->batch(1000) as $value){
  2. //do something
  3. //print_r(count($value));
  4. }

19、关于CSRF验证
方法一:关闭Csrf,除非必要,否则不推荐

  1. public function init(){
  2. $this->enableCsrfValidation = false;
  3. }

方法二:普通提交,form表单中加入隐藏域

  1. "_csrf" type="hidden" id="_csrf" value="$app->request->csrfToken ?>">
  2. 方法三:ajax异步提交,加入_csrf字段
  3. var csrfToken = $('meta[name="csrf-token"]').attr("content");
  4. $.ajax({
  5. type: 'POST',
  6. url: url,
  7. data: {_csrf:csrfToken},
  8. success: success,
  9. dataType: dataType
  10. });

20、YII命令行生成数据库文件
自动列出可用的migrate文件

  1. php yii migrate
  2. vendor/callmez/wechat/migrations目录下生成数据表
  3. php yii migrate --migrationPath=@callmez/wechat/migrations
  4. 从当前应用/migrations/db1下初始化数据到db1
  5. php yii migrate --migrationPath=@app/migrations/db1 --db=db1

21.关联查询

  1. //客户表Model:CustomerModel
  2. //订单表Model:OrdersModel
  3. //国家表Model:CountrysModel
  4. //首先要建立表与表之间的关系
  5. //在CustomerModel中添加与订单的关系
  6. Class CustomerModel extends \yii\db\ActiveRecord
  7. {
  8. ...
  9. public function getOrders()
  10. {
  11. //客户和订单是一对多的关系所以用hasMany
  12. //此处OrdersModel在CustomerModel顶部别忘了加对应的命名空间
  13. //id对应的是OrdersModel的id字段,order_id对应CustomerModel的order_id字段
  14. return $this->hasMany(OrdersModel::className(), ['id'=>'order_id']);
  15. }
  16. public function getCountry()
  17. {
  18. //客户和国家是一对一的关系所以用hasOne
  19. return $this->hasOne(CountrysModel::className(), ['id'=>'Country_id']);
  20. }
  21. ....
  22. }
  23. // 查询客户与他们的订单和国家
  24. CustomerModel::find()->with('orders', 'country')->all();
  25. // 查询客户与他们的订单和订单的发货地址
  26. CustomerModel::find()->with('orders.address')->all();
  27. // 查询客户与他们的国家和状态为1的订单
  28. CustomerModel::find()->with([
  29. 'orders' => function ($query) {
  30. $query->andWhere('status = 1');
  31. },
  32. 'country',
  33. ])->all();

22、yii2中关闭debug后return $this->redirect($url);不能跳转,服务器报500错误。
问题分析:
1.必须 return 才能让$this->redirect($url);立马跳转, 而不执行后续代码;
2.redirect() 中指定了响应的 http status code,默认是302;
3.当执行$this->redirect($url)时,不管是否在后面加return false 、return true都没有用,还是继续执行完代码。使用header(“Location:$url”);exit;可以解决此问题,但是,这不是yii2的逻辑,并不完美。
解决办法:
【本文由php_sir的博客 http://blog.sina.com.cn/phpsir原创,未经授权禁止转载】
1.在正常情况下,使用return $this->redirect($url);
2.在解决方案1不生效时,用$this->redirect($url);Yii::$app->response->send();
3.在解决方案2不生效时,用$this->redirect($url);Yii::$app->end();
总结:
Yii::$app->end();、Yii::$app->response->send();不管在actionXXX还是init方法都能终止代码,而return只能在action终止代码,是因为在init()里仅仅是代码的执行,return只是代码返回。

分类: web

标签:   yii2