2025-03-26

新しいブログサイト

tenkoma's blog に作りました。

2023-11-18

HatenaBlog Workflows Boilerplate を使ってみた

この記事は GitHub.com で下書きしました。

2023-05-21

【追記あり;不具合・修正されそう】PHPUnit 10 から、PhpStorm UIでテスト実行中の出力(echo, var_dump, etc...) が、テストログに出力されない

追記 2023/07/17 不具合としてレポートされ、議論が進んだ結果 10.2.6 (現時点で未リリース)で修正されるようです

報告されたPR: Proposal for progress output when using teamcity. #5367 by SakiTakamachi
実際に修正されたコミット: Closes #5445 by sebastianbergmann

追記前の本文

小ネタ。

PHPUnit 10.1 を利用したテストコードをPhpStorm から実行していて、上記の振る舞いの変化に気づいた。どのバージョンで変わったのか、どうすればいいのかを考えてみたい。

PHPUnit 9.6, 10.0 で振る舞いの違いを観察

検証環境は以下の通り

PHP 8.2.6
PhpStorm 2023.1.2
PHPUnit 9.6.8 (9系の最新バージョン), 10.0.0 (10系の最初のバージョン)

サンプルのテストコードは以下である。

<?php  
  
declare(strict_types=1);  
  
namespace Tenkoma\VardumpDuringTestExec\Test\Unit\Case;  
  
use PHPUnit\Framework\TestCase;  
  
class IntegerTest extends TestCase  
{  
    public function testVardump(): void  
    {  
        var_dump(['a' => 'b']);  
    }  
}

PHPUnit 9.6.8では出力された。

PhpStorm + PHPUnit 9.6.8でテスト実行中に var_dump() を実行した

PHPUnit 10.0.0では出力されなかった。

PhpStorm + PHPUnit 10.0.0でテスト実行中に var_dump() を実行した

他の出力形式の場合 (10.0.0)

PhpStorm からPHPUnit を呼び出しているときって、--teamcity ってオプションついてたけど、他の出力形式だとどうなんだろう？

PHPUnit 10.0.0 で、 `--teamcity` オプションをつけてテスト実行した

--teamcity オプションでテキストで出力させてみた。var_dump() 出力されない。

オプション未指定の場合。

--testdox 形式の場合

PHPUnit 10.0.0 で、 `--testdox` オプションをつけてテスト実行した

var_dump() 出力されない。また、例外がスローされている。(こちらの例外については検証してない)

他の出力形式の場合 (10.1.3)

最新版でも確認してみた。

PHPUnit 10.1.3 で、 `--teamcity` オプションをつけてテスト実行した

--teamcity の場合、出力されない。

未指定だと出力された。(10.0.0 → 10.1.3 のどこかで振る舞いが変わった)

PHPUnit 10.1.3 で、 `--testdox` オプションをつけてテスト実行した

--testdox でも出力された。(10.0.0 → 10.1.3 のどこかで振る舞いが変わった)

ここまでのまとめ

PhpStorm UI から PHPUnit テストケースを実行している場合、10.0以降、テスト実行中の出力(echo, var_dump, etc...)が出力コンソールに表示されなくなる (--teamcityオプションの振る舞いが変わった)
オプション未指定、--testdox 指定の場合も 10.0.0 では出力されなくなっていたが、最新の10.1.3 では出力されるようになっている

どうすればいいか

いくつか考えてみた。

開発者テスト(Testing)で `var_dump()` を使いたくなるのを改善する

アサーションせずに var_dump()したくなるのは、

プロダクションコードがテストし辛い状態である
テストコードが理解しにくかったり実行し辛い状態である
プログラマの実装スキルが不足している状態である
プログラマのテストスキルが不足している状態である

などのうちいずれかの兆候もしくは全部の兆候の可能性があるので、開発プロセスやプログラミングに改善の余地がある。はい。 (自己ツッコミ)

Xdebugリモートデバッグ連携して、ブレークさせて、変数を確認する

準備の手間がありますが、便利。

出力をアサーションして、Diffウインドウで確認する

var_dump() などの出力が、実際にコンソールに出力されないのは、PHPUnitが出力バッファ制御を使っているから
出力バッファ制御を使っている理由は、出力結果のアサーションで利用するため

なので、出力をアサーションすれば、間接的に結果が得られる。

`expectOutputString()` で、`var_dump()` 出力をアサーションし、エラー出力を見る

出力バッファに蓄積したデータを取得してアサーションする

前述の方法とほぼ同じ

`TestCase::output()` で出力バッファのデータを取得してアサーション

PHPUnit 10.1.3 最新版だと、`--teamcity` 指定しなければ、出力されるので、シェルから実行する

前述の通り、検証した結果 PhpStorm 連携をあきらめれば、var_dump() 出力が得られることがわかったので、--teamcity を指定しなければOK。

`ob_flush()` を呼び出して、出力バッファに蓄積されたデータを出力する

テスト実行中のデータは出力バッファに蓄積されているので、それを出力させる。この方法は、テストコードに expectOutputString() アサーションがあると、Failする可能性がある。

2022-05-22

メールアカウントをGoogle Workspaceに移行して、1つに集約することにした

20年前からインターネット利用してて、メールアドレスが増えてきてそれぞれのアカウントを見に行くのが面倒くさくなったので、Google Workspaceに移行することにした。スマホアプリの通知もそうだが、自分に不要な通知に煩わされる生活にならないようにしたい。

いままで以下のメールアドレスを使ってきた

(1) hotmail.com のメールアドレス
- 2000年より少し前に取得したもの。ほぼ個人連絡用に使っていたが、いまはほぼ使わず
(2) tenkoma.net のメールアドレス
- 2004年に使い始めた、さくらのメールボックスで3つのアカウントを作っていた。いまはネットサービス向けのもの以外はほとんど使っていない
  1. ネットサービス向けアカウント…AmazonやNetflixなどのオンラインサービス会員登録用。ずっと利用し続けていた
  2. 個人連絡用…2, 3年は使っていたが2010年からはまったく使わなくなった
  3. ウェブサイト管理者用…作ったけどほぼ使わず
- さくらのドメインで契約中
(3) gmail.com のメールアドレス
- 2005年取得した。個人連絡とネットサービスの両方で使っているが日常的には見に行かない
- Google One ベーシック契約中
(4) me.com (icloud.com) のメールアドレス
- 2009年頃、サービス名がMobileMeだったころに使い始めた。ネットサービスと個人連絡用に使っている。
- iCloud+ 50 GB ストレージ付き契約中

ネットサービスと個人連絡用でいまでも使っているのは (2)-1, (3), (4)である。移行を思い立ったのは、メインで使っていた(2)-1 のさくらのレンタルサーバのメールボックスに迷惑メールがくる頻度が増えてきて(1日平均5通以上) 振り分けが面倒くさくなったのも大きい。

Google Workspace にした理由

サービスをたいして比較検討したわけではなく、3つの選択肢から選んだ。

Google Workspace
個人用Gmail…(3) に集約する
iCloud メールアドレス(me.com)…(4) に集約する

の3つを思いついた。 1,2,3 のどれでも独自ドメインでの運用はできるらしい。しかし、1はキャッチオール機能があり、ネットサービスを新しいメールアドレスに移行せずに使い始めて、あとからネットサービスの登録メールアドレスを変更していけるのが良かった。

キャッチオールアドレスを設定すると、ドメイン内の実在しないメールアドレスに誤って送信されたメールも受信できます。

Google Workspace でのメールのルーティングと配信のオプション

個人用Gmailで、デフォルトで広告が出ないのもよい

大まかな移行手順

ひとまず、管理者アカウント登録〜キャッチオール設定までやれば、独自ドメインメールアドレスをGmailで受信できるようになるので、それ以降のメールデータ移行や、Webサービスアカウントの切り替えは後でゆっくりできる

管理者アカウント登録
ドメイン認証
MXレコード設定
キャッチオール設定

ここまでは約1時間でできた。キャッチオール設定で、アカウントが存在しない場合、すべて管理者アカウントのGmailに届くので移行後に「(2)の独自ドメインで作ったメールアドレス 3つ」に届いても、逃さずに済む。

SPF/DKIM/DMARC 設定

SPFの設定はすぐできた。 DKIM鍵の設定は、ヘルプだと24〜72時間でDKIM鍵が取得できるようになると書かれているが、実際には5日以上経たないと取得できなかった。またさくらのドメインコントロールパネルの制限で2048bitの鍵は設定できず。(ドメインも移管したくなった)

重要: 組織で Gmail を有効にした後、24～72 時間ほど待ってから、管理コンソールで DKIM 鍵を取得してください。待ち時間が経過する前に鍵を生成しようとすると、[DKIM 認証の設定を更新できませんでした] というエラーが表示される場合があります。

ドメインで DKIM を有効にする

ネットサービスのアカウント移行

アカウントの移行は、Google Workspace Gmail にメールが届いて、受信メールアドレスが古いメールアドレスだったら 古いユーザー名@ というラベルをつけるようにして、自分にアカウント移行を促すようにした。

メールデータの移行

(1) hotmail.com, (4) me.com のメールデータはメール(Mac App)のUI上でhotmailとGmailのアカウントを追加してコピーペーストした。
(2) tenkoma.net のメールデータはThunderbird(Mac App)のUI上でhotmailとGmailのアカウントを追加してコピーペーストした。
(3) gmail.com まだ移行してない

移行してどうだった？

2022/5/4に使い始めて2週間ちょっとになる。 (2)-1 に1日平均5通以上届いていた迷惑メール、フィッシングメールがほぼ届かなくなった。管理コンソールからメールログ検索してみるとまだちらほら送られてきて入るが、Gmail受信箱までは届かない。この2週間で1件だけGmailまで届いたが、迷惑メールとして振り分けられていた。