STEP UP BLOG

Laravelの開発環境でカスタムエラーページを表示させないために

Laravel 5.2対象。
Laravel 5.2では、
resources/views/errors
以下に
resources/views/errors/404.blade.php
resources/views/errors/500.blade.php
のようにHTTPステータスコードのビューファイルを置くことで、独自のエラーページを表示させることができます(ステータスコードでなくてもできますが)。
しかし、開発環境では小綺麗なエラーページでなく、どんなエラーがどこで起きたか知りたいのが常。
というわけで本番環境ではないときに、カスタムエラーページではなくLaravelのエラースタックトレース画面を表示させるにはどうすればいいか。
Laravel 5.2でのエラーハンドリングは、
app/Exceptions/Handler.php のHandlerクラスが取り扱っています。
このクラスはExceptionHandlerクラスを継承していて、ExceptionHandlerクラスにはrenderHttpExceptionメソッドといういかにもそれっぽいメソッドがあります。
このrenderHttpExceptionメソッドがカスタムエラーページを描画しています。
そこでrenderHttpExceptionメソッドをHandlerクラスでオーバーライドしましょう。

/**
 * Render the given HttpException.
 *
 * @param  \Symfony\Component\HttpKernel\Exception\HttpException  $e
 * @return \Symfony\Component\HttpFoundation\Response
 */
protected function renderHttpException(HttpException $e)
{
    if (!App::environment('production')) {
        return $this->convertExceptionToResponse($e);
    }

    return parent::renderHttpException($e);
}

上記をHandler.php内に記述すれば、本番環境以外でカスタムエラーページが表示されなくなります。
という感じで快適なLaravelライフを(^人^)

サーバが増えるとつらい

最近行なった七面倒な作業にサーバ10台以上にSSL証明書をインストールするというものがありました。
めんどー！泣
sshログインして証明書を更新してApacheを再起動して、と1台目のサーバで作業した時点でこれは大変だと気付いたので、インストール用のシェルプログラムを書いて出来る限り自動化したのですが、それでもそこそこの時間がかかりました。
サーバ毎に確認も必要で、なんですべてのサーバに証明書を置かないといけないのかと。。。
こういう複数サーバ構成だと、やはりロードバランサーにSSL証明書を起きたいものです。
即ちELB。(E)えげつないほど(L)楽ちんで(B)便利なロードバランサーことELB。
ELB使うと楽ですよね。
AWSにロックインされてしまいますが。
操作もシンプルですし、唯一リダイレクトループにさえ気をつければこれほど便利なサービスはないと思います。
ELBを使えばSSL証明書もELBに置きさえすればいいのでサーバ毎のインストールは必要ありません。
というわけで、これから規模の大きいサーバ構成にしたいときはAWSをメインに検討していきたいですね。

CentOS6以前とCentOS7でのよく使うコマンドのメモ

主にWebサーバを動かすときによく使うコマンドを挙げています。

・サービス一覧
CentOS6以前

$ chkconfig --list

CentOS7

$ systemctl list-units --type=service

・サービスの状態、起動、停止、再起動(例:httpd)
CentOS6以前

# service httpd status
# service httpd start
# service httpd stop
# service httpd restart

CentOS7

# systemctl status httpd.service
# systemctl start httpd.service
# systemctl stop httpd.service
# systemctl restart httpd.service

・ファイアウォール
CentOS6以前

# iptables -nvL
# iptables -A INPUT -p tcp -m tcp --dport 443 -j ACCEPT

CentOS7

# firewall-cmd --list-services --zone=public --permanent
# firewall-cmd --add-service=https --zone=public --permanent

firewalldはサービス名で追加削除できるのでわかりやすいですね。

Font Awesome

仕事でFont Awesomeを使ってます。
Font AwesomeはフリーのWebアイコンフォントです。
商用利用可能です。
http://fontawesome.io/
味気ない業務サイトも見出しやメニューなどにアイコンが付くと、とたんにフレンドリーに見えてきます。
使い方も簡単です。
http://fontawesome.io/examples/
アイコンの種類も豊富で日々増えています。
だいたい欲しいアイコンは揃っています。
http://fontawesome.io/icons/
バッテリーアイコンなど残量に応じて11種類のアイコンが用意されています。
これさえあれば他に何も要らないレベルです。
もうアイコンだけで会話ができるレベルです。
サイトにもう一味わかりやすさを求めているときに活用してみてはどうでしょうか。

MySQLのSQLプロファイリング

MySQLの実行が遅いときはチューニングが必要です。
MySQLのSQLチューニングですが、基本中の基本がexplainです。
スロークエリログで見つけた遅いSQLをexplainで実行して、適切なインデックスが使用されているか調べるのが、まずはチューニングの第一歩です。
それでも高速化したいSQLのどこが遅いのかわからないときはSQLのプロファイリング情報を調べます。
プロファイリングは以下のようにして表示できます。

mysql> SET PROFILING = 1;
Query OK, 0 rows affected (0.00 sec)

mysql> SELECT ...
...
...
117 rows in set (6 min 54.15 sec)

mysql> SHOW PROFILE;
+------------------------------+------------+
| Status                       | Duration   |
+------------------------------+------------+
| starting                     |   0.000246 |
| checking permissions         |   0.000004 |
| checking permissions         |   0.000003 |
| checking permissions         |   0.000002 |
| checking permissions         |   0.000002 |
| checking permissions         |   0.000002 |
| checking permissions         |   0.000002 |
| checking permissions         |   0.000002 |
| checking permissions         |   0.000002 |
| checking permissions         |   0.000005 |
| Opening tables               |   0.000030 |
| System lock                  |   0.000005 |
| Table lock                   |   0.000094 |
| optimizing                   |   0.000032 |
| statistics                   |   0.000051 |
| preparing                    |   0.000033 |
| Creating tmp table           |   0.000026 |
| executing                    |   0.000003 |
| Copying to tmp table         |   0.161709 |
| Sorting result               |   0.000767 |
| Sending data                 |   0.002630 |
| removing tmp table           |   0.000008 |
| Sending data                 |   0.000007 |
| init                         |   0.000112 |
| optimizing                   |   0.000022 |
| statistics                   |   0.000041 |
| preparing                    |   0.000030 |
| Creating tmp table           |   0.000066 |
| executing                    |   0.000003 |
| Copying to tmp table         |   0.050874 |
| converting HEAP to MyISAM    |   0.033028 |
| Copying to tmp table on disk | 103.846074 |
| Sorting result               | 158.297312 |
| Sending data                 | 151.018799 |
| end                          |   0.000026 |
| removing tmp table           |   0.807298 |
| end                          |   0.000016 |
| query end                    |   0.000004 |
| freeing items                |   0.000045 |
| removing tmp table           |   0.000009 |
| freeing items                |   0.000010 |
| removing tmp table           |   0.000004 |
| freeing items                |   0.000005 |
| removing tmp table           |   0.000006 |
| freeing items                |   0.000033 |
| removing tmp table           |   0.000007 |
| closing tables               |   0.000011 |
| logging slow query           |   0.000002 |
| logging slow query           |   0.000006 |
| cleaning up                  |   0.000007 |
+------------------------------+------------+
50 rows in set (0.00 sec)

上記のように調べたいSQLを実行した後にSHOW PROFILEします。
これはJOINの多いSQLを実行したときですが、めちゃくちゃtmpテーブルを作ってますね。。。
この場合はそもそもJOINがここまで必要とするテーブル構成でいいのか疑問となってきます。
また、"Sorting result"に時間がかかっているのでORDER BYかもしくはGROUP BYがボトルネックとなっていると思われます。
これ以外に手軽にできるチューニングというと、あとはバッファサイズの変更でしょうか。これはサーバスペックなどとにらめっこしながら適正値を探っていかないとなりません。
という感じで、今回はMySQLのSQLプロファイリング情報を調べてボトルネックを突き止めるということをまとめてみました。

既存PHPに後から拡張モジュールをインストールする

既にインストールされているPHPに後から拡張モジュールを追加しないといけない場合があると思います。
そのようなときの拡張モジュールのインストール手順です。
今回は例としてzipモジュールをインストールします。
PHPを新しくインストールするときならば--enable-zipをconfigureオプションとして指定すればいいのですが、この場合既にPHPはインストールされているのでそうもいきません。
尚、PHPをソースコードからコンパイル、インストールした場合で、HTTPサーバはApacheです。

$ cd /usr/local/src/php-5.x.xx/ext/zip

PHPソースコードのディレクトリにはextという拡張モジュールのソースコードが入っているディレクトリがあるので、extの中の該当するモジュールのディレクトリに移動します。

$ sudo /usr/local/bin/phpize
$ sudo ./configure --with-php-config=/usr/local/bin/php-config
$ sudo make
$ sudo make test
$ sudo make install
$ sudo vi /usr/local/lib/php.ini
+ extension=zip.so
$ sudo service httpd restart
$ php -i | grep zip
Registered PHP Streams => compress.zlib, php, file, glob, data, http, ftp, zip, phar  
gzip compression => enabled
bzip2 compression => disabled (install pecl/bz2)
zip
Libzip version => 0.10.1

以上となります。
configureでphp-configのエラーが出る場合は--with-php-configでphp-configのパスを指定してあげます。
簡単ですね。
という感じで気軽にモジュールは追加していったらいいと思います(外す場合はphp.iniのextension記述を削除すればいいので)。

PsySHでPHPのREPL

RubyやPythonなどと同様にPHPにもREPLがあります。
それがPshSHです。
REPLとは"Read Eval Print Loop"の略で対話型の実行環境を指します。

http://psysh.org/

ありがたいことに最新のLaravel5.3では自動でインストールされます。
入ってなくてもcomposerを使えば簡単にインストールできます。

$ composer require psy/psysh:@stable

まずは起動してみます。

$ ./vendor/psy/psysh/bin/psysh 
Psy Shell v0.8.0 (PHP 7.1.0 — cli) by Justin Hileman
>>> help
  help       Show a list of commands. Type `help [foo]` for information about [foo].      Aliases: ?                     
  ls         List local, instance or class variables, methods and constants.              Aliases: list, dir             
  dump       Dump an object or primitive.                                                                                
  doc        Read the documentation for an object, class, constant, method or property.   Aliases: rtfm, man             
  show       Show the code for an object, class, constant, method or property.                                           
  wtf        Show the backtrace of the most recent exception.                             Aliases: last-exception, wtf?  
  whereami   Show where you are in the code.                                                                             
  throw-up   Throw an exception out of the Psy Shell.                                                                    
  trace      Show the current call stack.                                                                                
  buffer     Show (or clear) the contents of the code input buffer.                       Aliases: buf                   
  clear      Clear the Psy Shell screen.                                                                                 
  history    Show the Psy Shell history.                                                  Aliases: hist                  
  exit       End the current session and return to caller.                                Aliases: quit, q               
>>>

>> $arr = [1,2,3];
=> [
     1,
     2,
     3,
   ]
>>> 1 + 2;
=> 3
>>> function square($x) {
... return $x*$x*$x;
... }
=> null
>>> square(4);
=> 64

というようにインタラクティブにPHPを実行できます。
試してみてはいかがでしょうか。
それではよいお年を。

privateの罠

最近ハマった挙動について書きます。
コードを見たほうが早いので以下にコード。

<?php

class ClassA
{
    private $member_variable = 'A';

    public function getMemberVariable()
    {
        return $this->member_variable;
    }
}

class ClassB extends ClassA
{
    private $member_variable = 'B';

    public function getMemberVariable()
    {
        return $this->member_variable;
    }
}

class ClassC extends ClassA
{
    private $member_variable = 'C';
}

$a = new ClassA();
$b = new ClassB();
$c = new ClassC();

echo $a->getMemberVariable()."\n";
echo $b->getMemberVariable()."\n";
echo $c->getMemberVariable()."\n";

$ php test.php 
A
B
A

$c->getMemberVariable()で"C"が返ってくると思ったら"A"でした。。
"C"を返すには以下のようにprivateをprotectedに変えるとできます。

<?php

class ClassA
{
    protected $member_variable = 'A';

    public function getMemberVariable()
    {
        return $this->member_variable;
    }
}

class ClassB extends ClassA
{
    protected $member_variable = 'B';

    public function getMemberVariable()
    {
        return $this->member_variable;
    }
}

class ClassC extends ClassA
{
    protected $member_variable = 'C';
}

$a = new ClassA();
$b = new ClassB();
$c = new ClassC();

echo $a->getMemberVariable()."\n";
echo $b->getMemberVariable()."\n";
echo $c->getMemberVariable()."\n";

$ php test.php 
A
B
C

子クラスから親クラスのメソッドを呼んで、そのメソッド内でprivate変数を呼ぶと親のprivate変数になるんですね。
理屈がわかればなるほどなんですが、どこがおかしいのか見つけるのが意外と難しかったです。。

rsyncのスラッシュありなしの注意点

rsyncでたまに大きいディレクトリを同期し終わってから失敗したとならないための注意。
同期元にスラッシュをつけるかつけないかの話です。
以下、例です。

$ ls
.  ..  dst  src
$ ls src
.  ..  a.txt  b.txt  c.txt
$ ls dst
.  ..

スラッシュあり

$ rsync -avh src/ dst
sending incremental file list
./
a.txt
b.txt
c.txt

sent 226 bytes  received 72 bytes  596.00 bytes/sec
total size is 6  speedup is 0.02
$ ls dst
.  ..  a.txt  b.txt  c.txt

スラッシュなし

$ rsync -avh src dst
sending incremental file list
src/
src/a.txt
src/b.txt
src/c.txt

sent 240 bytes  received 73 bytes  626.00 bytes/sec
total size is 6  speedup is 0.02
$ ls dst
.  ..  src
$ ls dst/src/
.  ..  a.txt  b.txt  c.txt

スラッシュがあると中のファイルだけを同期させますが、スラッシュがないとディレクトリごと同期させるようになります。
目的によりますが、気をつけないと想定していないディレクトリ構成となって同期してしまうので注意しましょう。

html5のdownload属性

Webサイトから何かファイルをダウンロードさせたいとき、例えば、

ダウンロードサンプル

のようにリンクを貼った場合、ファイルの種類によってはダウンロードではなくブラウザで表示するかたちになります(PDFなど)。
気を利かせて開いてくれたのはうれしいけれど、今見たいわけじゃないんだブラウザ君。
というわけでそんなときに便利なのがhtml5で仕様が作られたdownload属性です。

https://developer.mozilla.org/ja/docs/Web/HTML/Element/a

ダウンロードサンプル

のように書くと、リンク先が明示的にダウンロードされるようになります。しかも

ダウンロードサンプル

のように書くと、ダウンロードするときのファイル名までも指定できます。
便利！！
しかも！！
一部のブラウザまたの名をSafariやIEではこの属性は使えません！！
早く対応してください＞＜