Lycolog

PHPでClassをrequireせずに使えるやつ
Laravelのrequest()とかがどうやって呼ばれてるのかを調べていくうちに辿り着いたのでメモがてら

Classは簡単に読み込めるけど、Functionは一筋縄ではいかなさそう
ついでにClassに好き勝手プロパティ増やせることも発見した

• autoloaderを実装
• 使いたいクラス
• autoloaderを呼んで使う

autoloaderを実装

spl_autoload_registerを使う。Laravelはcomposerが上手いことやってくれてるっぽかった

<?
function regist() {
    spl_autoload_register(function() {
        require './Hoge.php';
        require './Piyo.php';
    });
}

使いたいクラス

適当に用意

<?
class Hoge {
    public $hoge;
}

<?
class Piyo {
    public $piyo;
}

autoloaderを呼んで使う

ついでに好き勝手にプロパティも生やす

<?
require './bootstrap.php';
// ここでクラスをautoloadする
regist();

// どこからも呼んでないけど
$h = new Hoge;
// 生やせる
$h->fuga = "aaa";
$h->hogepiyo = "bbb";

// 使える
$p = new Piyo;
$p->fuga = "aaa";
$p->hogepiyo = "bbb";

var_dump($h, $p);

/*
結果

class Hoge#2 (3) {
  public $hoge =>
  NULL
  public $fuga =>
  string(3) "aaa"
  public $hogepiyo =>
  string(3) "bbb"
}

class Piyo#3 (3) {
  public $piyo =>
  NULL
  public $fuga =>
  string(3) "aaa"
  public $hogepiyo =>
  string(3) "bbb"
}

*/

• サンプルはこちら

手順

1. composer initでプロジェクトを作成
2. composer require [パッケージ名]でパッケージを入れる
3. 名前空間を作る場合、 composer.jspnに以下のセクションを作成
   1. リファレンス: getcomposer.org

"autoload": {
    "psr-4": {
        "App\\": "src/App" // 名前空間と対応するパス
    },
    "classmap": [
        "src/App" // クラスを読み込むディレクトリのルート
    ]
}

1. autoloadやclass_aliasなどを設定するbootstrap.phpを適当に作成
   1. このbootstrap.phpはエントリポイントからrequire_onceなどで読み込無事で有効化する
2. phpunitを組み込む場合
   1. composer require --dev phpunit/phpunitでインストール
   2. composer.jsonに以下のセクションを作成

    "scripts": {
        "test": [
            "phpunit --bootstrap bootstrap.php test"
        ]
    }

• 確認環境
• やりたいこと
• 各ケース紹介
  • Case1 そもそも構文がおかしい
  • Case2 スコープ違いでテストが失敗する
  • Case3 テストが成功するケース

確認環境

やりたいこと

以下の実装のときに、parentFunc()を呼んだ時にchildFunc()が呼ばれることをテストしたい

function parentFunc() {
  console.log('called parentFunc');
  childFunc('XXXX');
}

function childFunc(param) {
  console.log(`called childFunc ${param}`);
}

各ケース紹介

Case1 そもそも構文がおかしい

テストするためには関数をexportする必要あるが、愚直過ぎて構文的に実行不能になるケース

exports.parentFunc = () => {
  console.log('called parentFunc');
  // childFuncは別モジュールなので呼べない
  childFunc('XXXX');
};

exports.childFunc = (param) => {
  console.log(`called childFunc ${param}`);
};

Case2 スコープ違いでテストが失敗する

この実装を実行すると期待通り動作するので、一見すると大丈夫そうに見える

function parentFunc() {
  console.log('called parentFunc');
  childFunc('XXXX');
}

function childFunc(param) {
  console.log(`called childFunc ${param}`);
}

module.exports = { parentFunc, childFunc };

しかしこのテストを流すと失敗する
これはparentFunc()が呼び出すchildFunc()が下記case2の中にないため
parentFunc()のスコープ内にchildFunc()がいないことが原因

const case2 = require('./case2');
// こうするとjest.spyOn()の第一引数を満たせないので落ちる
// const { parentFunc, childFunc } = require('./case2');

describe('inside call test', function () {
  it('parentFunc', function () {
    const spy = jest.spyOn(case2, 'parentFunc');
    case2.parentFunc();
    expect(spy).toHaveBeenCalled();
  });
  it('childFunc', function () {
    const spy = jest.spyOn(case2, 'childFunc');
    case2.parentFunc();
    // childFuncはcase2に属していないため呼ばれない
    expect(spy).toHaveBeenCalled();
  });
});

Case3 テストが成功するケース

const parentFunc = () => {
  console.log('called parentFunc');
  // parentFunc()の中にchildオブジェクトを注入することで、
  // jestがchildFunc()を認識できるようにする
  child.childFunc('XXXX');
};

const child = {
  childFunc: (param) => {
    console.log(`called childFunc ${param}`);
  },
};

// childFuncでなく、childオブジェクトをexportするのが味噌
module.exports = { parentFunc, child };

const case3 = require('./case3');

describe('inside call test', function () {
  it('parentFunc', function () {
    const spy = jest.spyOn(case3, 'parentFunc');
    case3.parentFunc();
    expect(spy).toHaveBeenCalled();
  });
  it('childFunc', function () {
    // 注入している側のオブジェクトを参照する
    const spy = jest.spyOn(case3.child, 'childFunc');
    case3.parentFunc();
    // child.childFuncはcase3に属しているため呼ばれる
    expect(spy).toHaveBeenCalled();
  });
});

GitHub Pagesにドメインを紐付ける

# ルートドメイン, cnameだとメールが届かなくなるのでaliasを使う
alias @ example-user.github.io.
# サブドメイン
cname sub example-user.github.io.

メールサーバーは分けたい

メールサーバーがさくらインターネットの場合はこんな感じで行ける

mx xxx.xxx.xxx.xxx. 10
txt xxx.xxx.xxx.xxx. v=spf1 a:wwwXXXX.sakura.ne.jp mx ~all
a mail xxx.xxx.xxx.xxx

Let’s EncryptのDNS-01チャレンジの設定方法

• サブドメインのケースで書いてる
• ワイルドカード証明書の設定も確かできたはずだが、今ん所使える環境がないので書いてない
• @lycolia/value-domain-dns-cert-registerで自動更新できる

  a sub xxx.xxx.xxx.xxx
  txt _acme-challenge.sub XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
  

パターンを思い付く都度に更新される予定。

• yyyy-MM-dd HH-mm-ssをyyyy-m-dに変換
• 3桁区切りカンマ
• ネストプロパティの2段目(bar)以降を配列に置換
  • 但しメソッドは対象外にしたい場合
• 参考

yyyy-MM-dd HH-mm-ssをyyyy-m-dに変換

s/(\d{4})-0?(\d{1,2})-0?(\d{1,2}).+/$1-$2-$3/

3桁区切りカンマ

s/(\d)(?=(\d{3})+(?!\d))/$1,/g

直後に\d{4}でなく、\d{3}のパターンのある\dをキャプチャし、カンマを付与

ネストプロパティの2段目(bar)以降を配列に置換

s/(?<=\$request->.+?)->((?<!\$request->)(?<=->)([a-z_]+))+/['$2']/gi

1. まず(?<=\$request->.+?)はキャプチャされず、この次に->があるのが前提、->は削除するので先読み・後読み・キャプチャはしない
2. 次に式などで文章が両辺にあることを考慮して、文字列内に\$request->が再度含まれないことを(?<!\$request->)として条件にする
   1. これを入れてないと一行中の一文と解釈されるので、別の文と解釈させるため
3. 次にプロパティ名の前には->が来るので、それを(?<=->)として条件付けする
4. 最後に([a-z_]+)でプロパティ名であろうものを指定する
5. 2-4の繰り返し（ルートにある2個目のカッコ）に対して置換を掛けることでプロパティ名を配列に置換できる
6. 但し1で指定している->単体は繰り返し対象外なのに繰り返し適用されているが、この理由はよくわかってない
   1. 恐らく単純に(?<=\$request->.+?)の後ろにある->が全部消えている？

// source text
$request->foo
$request->foo;
$request->foo->bar;
$request->foo['bar'];
$request->foo->bar->fb->fBfb;
$arr = [
  'bar' => $request->foo->bar
];
if ($request->foo->bar->fb= $request->foo->bar->fb) {
  $request->foo->bar->fb = $request->foo->bar->fb;
}

// replaced text
$request->foo
$request->foo;
$request->foo['bar'];
$request->foo['bar'];
$request->foo['bar']['fb']['fBfb'];
$arr = [
  'bar' => $request->foo['bar']
];
if ($request->foo['bar']['fb']= $request->foo['bar']['fb']) {
  $request->foo['bar']['fb'] = $request->foo['bar']['fb'];
}

但しメソッドは対象外にしたい場合

s/(?<=\$request->.+?)->((?<!\$request->)(?<=->(?![a-z_]+\(\)))([a-z_]+))+/['$2']/gi

• ->の後に来るメソッド構文を除外するために、(?![a-z_]+())を追加
• (?<=->(?![a-z_]+()))とすることで->の後に来る(?![a-z_]+())を除外しつつ、->の後に来る([a-z_]+)をキャプチャできる

// source text
$request->foo
$request->foo;
$request->foo->bar;
$request->foo['bar'];
$request->foo->fooBar();
$request->foo->bar->fooBar();
$arr = [
  'bar' => $request->foo->bar
];
if ($request->foo->bar->fb= $request->foo->bar->fb) {
  $request->foo->bar->fb = $request->foo->bar->fb;
}

// replaced text
$request->foo
$request->foo;
$request->foo['bar'];
$request->foo['bar'];
$request->foo->fooBar();
$request->foo['bar']->fooBar();
$arr = [
  'bar' => $request->foo['bar']
];
if ($request->foo['bar']['fb']= $request->foo['bar']['fb']) {
  $request->foo['bar']['fb'] = $request->foo['bar']['fb'];
}

参考

• 正規表現の先読み・後読みを極める！
• 鬼車 正規表現