OSS Gate Workshop: Fukuoka: 2019-01-15: garcons: cakephp/chronos: Work log

[MizukiMatsutani]

This is a work log of a "OSS Gate workshop". "OSS Gate workshop" is an activity to increase OSS developers. Here's been discussed in Japanese. Thanks.

作業ログ作成時の説明

以下のテンプレートを埋めてタイトルに設定します。埋め方例はスクロールすると見えてきます。

OSS Gate Workshop: ${LOCATION}: ${YEAR}-${MONTH}-${DAY}: ${ACCOUNT_NAME}: ${OSS_NAME}: Work log

タイトル例↓：

OSS Gate Workshop: Tokyo: 2017-01-16: kou: Rabbit: Work log

OSS Gateワークショップ関連情報

• スライド：ワークショップの進行に使っているスライドがあります。
• チャット：OSS開発に関することならなんでも相談できます。ワークショップが終わった後もオンラインで相談しながら継続的にOSSの開発に参加しましょう！
• シナリオ：ワークショップの目的・内容・進め方の詳細が書いています。
• 過去のビギナーの作業ログ：他の人の作業ログから学べることがいろいろあるはずです。

[monochromegane]

わいわい！

[MizukiMatsutani]

開始する

[monochromegane]

ライセンス一覧: https://opensource.org/licenses/alphabetical

[MizukiMatsutani]

「chronos」でググるが、全然違うものばっかりヒットするので、「chronos php」でググると良さげ。 GitHubとCakePHPでの利用方法（公式っぽい）Documentが見つかった。が、CakePHPは動かさないので、除外

• GitHub https://github.com/cakephp/chronos
• CakePHP https://book.cakephp.org/3.0/ja/chronos.html

[MizukiMatsutani]

GitHubでライセンス見る https://github.com/cakephp/chronos/blob/master/LICENSE

[MizukiMatsutani]

↑のページで「MIT License」ってなっているので、ライセンス一覧（https://opensource.org/licenses/alphabetical）から探す。

[MizukiMatsutani]

ライセンス一覧にMITがあったので、OSSと判断

[MizukiMatsutani]

GitHubのREADMEを見てローカルにインストールしてみる https://github.com/cakephp/chronos

[MizukiMatsutani]

説明読んで見る。

Chronos aims to be a drop-in replacement for nesbot/carbon. It focuses on providing immutable date/datetime objects. Immutable objects help ensure that datetime objects aren't accidentally modified keeping data more predictable.

Google先生に訳してもらってなんとなく掴む。「carbonに変わるイミュータブルで予期せぬバグが起きにくいよ」らしい。 すげーいいじゃん。

[MizukiMatsutani]

インストールからやってみる。 https://github.com/cakephp/chronos#installation

[monochromegane]

経過がわかりやすいGreat issueだ!

[MizukiMatsutani]

composer require cakephp/chronos を叩く

流石にこのライブラリ落とすような人は大丈夫だけど、

mkdir path/to/your/directory
cd path/to/your/directory

とか当たり前すぎるけどcomposerとかがインストール前提であったがいいかも

[MizukiMatsutani]

インストールできたっぽい

$ composer require cakephp/chronos
Using version ^1.2 for cakephp/chronos
./composer.json has been created
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
  - Installing cakephp/chronos (1.2.3): Downloading (100%)         
Writing lock file
Generating autoload files

[MizukiMatsutani]

GitHubにあるサンプルソースを作って実行してみる。 以下をPrint.phpとして保存。

<?php
require 'vendor/autoload.php';

use Cake\Chronos\Chronos;

printf("Now: %s", Chronos::now());

[MizukiMatsutani]

実行してみる

$ php Print.php 
Now: 2019-01-15 11:20:05

できた

[tokibi]

順調そう

[MizukiMatsutani]

と思ったら、今20:20なんだけど。。。

[MizukiMatsutani]

$ date
2019年 1月15日 火曜日 20時22分43秒 JST

UTCなんかな

[MizukiMatsutani]

とりあえず、READMEを終えてから後でAPIドキュメントみて解決しよう

[MizukiMatsutani]

次に進む。けど、これはcarbonライブラリからの移行手順なので、今回はすっ飛ばす https://github.com/cakephp/chronos#migrating-from-carbon

[MizukiMatsutani]

ここやってみる。 https://github.com/cakephp/chronos#immutable-object-changes

[MizukiMatsutani]

サンプルには

// This will lose modifications
$date = new Chronos('2015-10-21 16:29:00');
$date->modify('+2 hours');

// This will keep modifications
$date = new Chronos('2015-10-21 16:29:00');
$date = $date->modify('+2 hours');

ってあるけど、イミュータブルであるよ！！て押したいのであれば、それを確認するソースがあってもいいんでない？

[MizukiMatsutani]

こうして、イミュータブルを確認した

// This will lose modifications
$date = new Chronos('2015-10-21 16:29:00');
$date->modify('+2 hours');

var_dump($date); // '2015-10-21 16:29:00'のまま！

// This will keep modifications
$date = new Chronos('2015-10-21 16:29:00');
$date2 = $date->modify('+2 hours');

var_dump($date !== $date2); // true！
var_dump($date); // '2015-10-21 16:29:00'のまま！
var_dump($date2); // '2015-10-21 18:29:00'になった

[MizukiMatsutani]

つぎ、ミュータブルを見る https://github.com/cakephp/chronos#getting-mutable-objects

[monochromegane]

良い提案〜

[MizukiMatsutani]

サンプルはこれ

$time = new Chronos('2015-10-21 16:29:00');
$mutable = $time->toMutable();

$date = new Date('2015-10-21');
$mutable = $date->toMutable();

new Date()で落ちる。 PHPってDateクラスあったっけ？DateTimeクラスの間違い？

[monochromegane]

見つけましたね...!! 既にIssueやPullRequestで同様のフィードバックがないかなども確認しておいても良さそうです

[MizukiMatsutani]

use Cake\Chronos\Date; がいる！！ もしくは $date = new Cake\Chronos\Date(); のほうが親切

[monochromegane]

来ましたね

[monochromegane]

落ちた時のエラーメッセージもメモしておくと良さそうですね~!

[MizukiMatsutani]

Fatal error: Uncaught Error: Class 'Date' not found のエラーが出た！

[MizukiMatsutani]

こっちもイミュータブルとと同じでミュータブルであることを確認できるサンプルがあるとメリット感あるかも。

[MizukiMatsutani]

https://github.com/oss-gate/workshop/issues/1024#issuecomment-454364701 指摘いただいたようにIssueとかPRみてみる。

[MizukiMatsutani]

次回、Issueを上げる。

• use してないとエラーになる https://github.com/oss-gate/workshop/issues/1024#issuecomment-454365147
• イミュータブルとミュータブルのメリットがわかるサンプル https://github.com/oss-gate/workshop/issues/1024#issuecomment-454362873

[oss-gate-issue-cleaner[bot]]

おつかれさまでした！

後日引き続きワークショップがある場合

後日のワークショップで再開する際に、issueタイトルの日付を更新してreopenしてください！

ワークショップ終了後に続きがしたい場合

issueはクローズしますが、その後も作業を続けていただいて大丈夫です！

是非このissueを活用なさってください。

今後のイベントの案内

現在以下のイベントの開催を予定しています。

• OSS Gate大阪ワークショップ2019-03-09
• OSS Gate東京ワークショップ2019-06-08
• OSS Gate東京ワークショップ2019-04-27
• OSS Gate東京ワークショップ2019-03-09
• OSS Gate東京ワークショップ2019-01-26
• OSS Gate東京もくもく会2019-01-25

参加をお待ちしてます！