質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

90.23%

phpのソース中に意図不明点

解決済

回答 1

投稿

  • 評価
  • クリップ 0
  • VIEW 609

hotta

score 1539

laravel5 の勉強がてらソースを見ていて、何をしたいのかよくわからないところが
ありました。

vendor/laravel/framework/src/Illuminate/Support/Str.php

98     /**
99      * Cap a string with a single instance of a given value.
100      *
101      * @param  string  $value
102      * @param  string  $cap
103      * @return string
104      */
105     public static function finish($value, $cap)
106     {
107         $quoted = preg_quote($cap, '/');
108
109         return preg_replace('/(?:'.$quoted.')+$/u', '', $value).$cap;
110     }

preg_quote($cap, '/') は、'/' および正規表現の特殊文字をすべてエスケープする。

http://php.net/manual/ja/function.preg-quote.php

正規表現の中の '?:' は、「値のキャプチャを行わない」
=パターンを見つけてもマッチさせない(無視する)ということ?
http://php.net/manual/ja/regexp.reference.subpatterns.php

/u は「UTF-8 として処理する」
http://php.net/manual/ja/reference.pcre.pattern.modifiers.php
ということのようです。

この finish() メソッドを使っている箇所を vendor/ 配下で grep してみましたが、
このラッパーであるヘルパー関数 str_finish() 以外は、残念ながら見つけられませんでした。

$ php artisan tinker
Psy Shell v0.7.2 (PHP 7.0.11 — cli) by Justin Hileman
>>> use Illuminate\Support\Traits\Macroable;
=> null
>>> $s = new Str;
=> Illuminate\Support\Str {#675}
>>> $s->finish("abc123[123][123]\[123\]/123/xyz", "[123]");
=> "abc123[123][123]\[123\]/123/xyz[123]"
>>> $s->finish("abc123[123][123]\[123\]/123/xyz", "/123/");
=> "abc123[123][123]\[123\]/123/xyz/123/"


preg_replace() の replacement が '' なので、セキュリティがらみ(?)で
何らかのパターンを排除(削除)しようとしているのではないかとも思うのですが、
どういうケースでこれが役立つのか、おわかりの方がおられましたら教えてください。

  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

回答 1

checkベストアンサー

+4

公式サイトに出ている例から推測される用途として、「パスの最後をスラッシュ終わりに統一する」という用法が考えられます。

/path/to/foo/bar/path/to/foo/bar/のどちらが来ても正しく処理できるようにこのような変換を入れることは、Laravelに限らずちょくちょくあります。

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2016/10/04 09:43

    ユースケースとしては理解できました。
    ノーマライズの一種ということですね。

    いったんこちらをベストアンサーとさせていただきますが、
    正規表現の意図(実際のコードの意味)についても、
    引き続きコメントをお待ちしております。

    キャンセル

  • 2016/10/04 09:54

    preg_quoteを入れないと、(この例でのスラッシュもそうですが)正規表現のメタ文字と認識されて、正常に動作しなくなります。

    キャンセル

  • 2016/10/04 10:05

    preg_quote() の公式マニュアルに載っている例から preg_quote() を
    外して実行したら、エラー(Compilation failed)になることを確認しました。
    ありがとうございました。

    キャンセル

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 90.23%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる