freedom-man.com

2025年の振り返り

Tue, 30 Dec 2025 21:15:00 +0900

今年もええ感じに振り返っていくよ！

仕事

今年やった主な仕事の記事はこちら

ざっくりいうと社内システム周りを中心にエンジニアリングしていた。 Google Cloud, Next.js, Prisma, Zod, FastAPI など今まであまり触ったこと無い技術を経験できたのがとても良かった。

それ以外だと、既存サービスのフロントエンド改善もやっていて、ViteによるJSビルド、Vitest・Alpine.js・Biome・TypeScriptの導入、不要コード削除などなど相変わらず色々やっていたり。おかげさまでレガシーフロントエンド改善も得意技になった感じ。

2024年の振り返りで

ビジネス理解や業務理解を高めるところがまだ全然できていない

と書いたのだが、今年はビジネス理解・業務理解をかなり深めれた一年だったと思う。このビジネス理解・業務理解のプロセスが非常に面白かったのと、自身のエンジニアリングに対する考え方がもう一段階ブラッシュアップされた感じもあり、得るものが大きかったように思う。

一方で、技術的なスケールといった課題に対しては行動量・成果ともにほとんどできなかった。スタッフエンジニアの４タイプでいうところのソルバーを相変わらずやっていた感じで、当初想定していたテックリード・アーキテクトあたりは全くできなかったのが残念。もうちょっと自分で動けるところはあったかもしれないが、開発から離れてしまった領域のテックリーディングは中々厳しく、開発しているサービスのテックリーディングの割合は少なかった（ソルバーの割合を強くしていくのが良いと判断した）という感じでなかなか難しい。

そもそも、この４タイプで考え過ぎてしまうこと自体がナンセンスな感じもしており、「業務理解」「ビジネス構造の理解」の上でステークホルダーコミュニケーションを含めた「プロジェクトリーディング」「プロダクトリーディング」があり、これらの能力を各人が身につけることが大事なのでは？という気持ちが強い。もちろんそれらを満たすのがスタッフエンジニアなのかもしれないんだけど、上記の能力を身に着けたうえでどこに比重を置くかが４タイプの違いでしかない感じがしている。

という示唆を与えてくれた貴重な１年だった。

アウトプット

今年は PHPerKaigi に登壇した。PHPerKaigiは久々の参加・登壇になったが、Alpine.js周りのニッチな話をめっちゃしたかったのでCfP通って嬉しいし発表できて良かった！

今年は（というか下半期は）自分のブログをかなり書いた。ソフトスキル面で色々と思っていることを公私ともにダンプしていなかったり、今時点での考え方をダンプしていくことは考えの整理など有用だと感じたのが主なモチベーション。また、ハードスキル面もネタが豊富にあるのにアウトプットする習慣がなくなっていたというのもある。11月以降はだいぶ失速したけど色々書けて楽しかった。

来年も登壇・ブログなどアウトプット量を増やせていけると良いなぁ。

育児

相変わらず楽しい。運動能力や言語能力が上がったり食べれるものが増えるようになったりと楽しみの幅が広がったように思う。喋れるようになった分色々大変というのはあるけど…ｗ

昨年12月は喘息で入院してたけど、今年は喘息の発作みたいなのはほとんど出ず、体調的にも特に問題なく安定して過ごせたのがとても良かった。旅行もたくさん行けた！

旅行

箱根、横浜（中華街側）、鬼怒川（with 母A）、沖縄、甲府、伊豆（with 母B）、ディズニーランド、横浜(みなとみらい側)、という感じでたくさん行った。

横浜・ディスニーは日帰りで行ける位置なのだが移動のストレスも結構あるし現地でゆったりしたかったので泊まってみたのだが、これが結構良かった。移動距離も旅行にしては短く、ホテルや周辺コンテンツが充実していたり、何か忘れても何とかなる安心感もとても良い…ｗ

ディズニーシーはここ数年で２回ほど行っていたんだけど、ランドの方は25年ぶりくらいに行った。懐かしさを感じたりシーとのコンセプトの違いを感じながら、普通に楽しめた。パレードはランドの方が好きかも。建造物とか雰囲気はシーが好きなのでシーもまた行きたいなぁ。ミラコスタ泊まりたい。

鬼怒川はスペーシアX、伊豆はサフィール踊り子の個室席を使った。個室の電車は本当に居心地が良いし、小さい子連れだと発する音が気にならないのでストレスが少ない。サフィール踊り子は海沿いなので海を見ながら移動できたりしてとても体験が良い。スペーシアXは海のコンテンツは無いものの、コクピットスイートというVIPな個室席があって超オススメ。どちらもホテルや航空機のVIPな席よりも遥かに安く利用できるので、移動で利用できるタイミングがある方はぜひ…！！

沖縄はオーシャンビューなホテルに泊まってマジ最高だった。他の旅行に比べると移動が大変（飛行機で2〜3時間、陸路でプラス2時間くらい）だったけどまぁ何とかなった…けどやっぱり大変だった。でも毎年何かしら南国には行きたいと思うくらいには本当に楽しかった。

ディズニーも伊豆も横浜もオーシャンビューな部屋だったんだけど、意外と飽きることなくいろんな海を堪能できたし、朝起きて海見れたり海辺を散歩できたりするのはマジで体験が良かった。

部屋からきれいなお庭が見えて、部屋からその庭の鯉に餌を上げれるような素敵な部屋に泊まったりもして、そういう風情のある旅館も良かった。

親孝行的な旅行ができたのものよかった。自分達がこれから親孝行できる期間のことを考えると年１回ずつくらいは一緒に行けると良いなぁと思っていたり。

来年は海外とか行けるんじゃないかと思いつつ未定。国内外問わず月１くらいでいけると良いなぁ。貸別荘系も気になっているし、行けていない地域もたくさんあるのでどんどん行きたい。

とまぁ色々パッション持って書けるくらいには旅行が楽しいフェーズだったりする。海外ももちろん行きたいんだけど、日本の旅館のクオリティが本当に高くて、一休とか見てると国内だけでもかなり良い宿があって時間とお金が足りない。これといった趣味が無い自分にとっては、もはや旅行のために働いているといっても良いかもしれない。

飲み会

昨年は会社の飲み会は１回だけあったっきりで歓迎会（自分のも含む）・送別会・忘年会・新年会がなくてアレだなぁと思って、今年の２月くらいに自分が飲み会を企画したりした。で、そのあたりを皮切りに、というかそのあとグループでちゃんとそういうのをやる体制が整ったり、飲み会を企画してくれる人が入社してくれたのもあり、飲み会をたくさんやった。

結果、会社の飲み会は8〜9回くらいやっていて、プライベートはそれ以上という感じでここ数年で一番飲み会をやった年になった。ちょくちょく体調不良とか予定合わずで休んだりしたけどそれでも結構多かった…ｗ

会社もプライベートも誘われるのはやっぱり嬉しいのでついつい参加しちゃいますねぇ。というのとやっぱり飲みながらじゃないと聞けない、話せないような話はそれなりにあるもので、そういう意味でも貴重な機会だし大事にしたい。

今年の振り返り＆来年に向けて

仕事では社内の人と飲みに行ったり仕事での関わりが増える中で、コミュニケーションとビジネス構造と業務理解がいかに大事かを思い知らされた１年だったように思う。これは自分のエンジニア観が少し変わったかもしれない、というくらいにはインパクトがあった。

あと知っている人の体調があれこれという話を聞いたりして、明日は我が身だし１日１日マジで大切に生きないといけないなぁと。冗談でも悲観的でもなくいつ何が起こるかわからない、ということをどこか頭の片隅に置かないといけないなと割と真剣に思っていたりする。

いずれにしてもワクワクやパッションが自分の原動力でありキャリアの源泉なので大事にしていきたいし、そういったワクワクやパッションを積極的に見つけていきたい。

あとは色んなところに旅行したい！！！

ということで今年も大変お世話になりました！
来年もよろしくお願いいたしまっす！！

Salesforceはなぜ負債になりやすいのか

Thu, 20 Nov 2025 22:05:00 +0900

※Salesforceを悪く言うつもりは全く無く、使い方を間違えなければとても良いツールだと思うし、何を使っても使い方と適材適所ですよね、という話です…！

Salesforceの負債の95%くらいは以下の3つの機能・特徴にあると思っています。

DMLをフックとした機能全般
データの取り回しのしづらさ
Apex/VF/LWCなどの開発・保守性が悪くなりがちな機能

1. DMLをフックとした機能全般

Salesforceに限らずDMLをフックとした機能は処理が追いづらく、影響範囲が読めないため保守性の悪化につながりやすいです。

Salesforceだとワークフロールール/プロセスビルダー/フロー/トリガーが該当しますし、Salesforce以外だとRails / ActiveRecordで言うところのcallback、Laravel / Eloquent でいうところのモデルイベント、DBでいうところのトリガーになります。

Salesforceだとノーコード・プロコードの機能が混在していてさらに処理が追いづらく、それらの処理が互いに作用してうまく動かないこともよくあります。トリガーが２回評価されたり、評価順による不具合発生もよくあります。フローのようなノーコード機能だとテストコードを書かないことがほとんどなので不具合も発生しやすいです。

Salesforce以外の場合はDMLフックの機能を利用せず、DMLと一緒にベタに処理を記述するというアプローチができます。Laravelだとこんな感じでコントローラなどに処理を書いていく形になります。

$hoge = Hoge::create($attr);
$hoge->sendMessage(...)

対象DML全てで共通化できないデメリットはありますが、処理の追いやすさと不具合の発生しづらさという意味では許容できるトレードオフなのかなと思っています。

では、Salesforceではどうなのかというと、VF/LWCなどApexが記述できる カスタムなページ や カスタムのAPI であれば対応できます。一方で、Salesforceの基本は標準機能である「一覧画面」「詳細画面」「作成・編集画面」　です。全てのオブジェクトでカスタムページを作って対応するのはとてもコストが高くSalesforceの良さを活かしきれません。そのため、画面に関しては標準機能を使って、それでも実現できないビジネスロジックはDMLフックの機能で実現するのがSalesforceの一般的なプラクティスです。データインポートウィザードやデータローダーによる一括作成・更新などのユースケースにも対応できるため、そこまでロジックが複雑でなければ比較的安牌な選択肢とも言えます。

しかしながら、前述のようにロジックが肥大化したりいろんな場所に無秩序に実装されたりすると負債化するのと、途中でDMLフック方式からカスタムページ形式に移行するのは腕力・体力のいる作業になるため、DMLフックの力学が強く働いてしまいます。テストコードのない処理に対して振る舞いを変えずにノーコードをコードに置き換えないといけない、という難しさは容易に想像がつくのではないかと思います。

2. データの取り回しのしづらさ

Salesforceの標準機能の詳細画面では1:N前提の関連表示しかありません。そのため、1:1でテーブル切って、詳細画面には親テーブルの項目と並列で項目を表示する、といった表現ができません。また、レポート機能では1:1の参照として項目を横並びに表示することが実質的¹にできません。

以上から、Webで言う1:1でテーブル分割した方が良いようなケースにおいても、1テーブルに全てまとめた方がSalesforceとしては取り回しが良いことになります。こうして1テーブルに項目が大量に詰め込まれるという力学が働くことになります。

データ移行に関してもWebと比べると難易度が高いです。一般的なRDBだと UPDATE xxx INSERT INTO ... SELECT ... のような一括更新の作業は考慮事項の多さはあれど、手順としてそこまで複雑になるケースは少ないような気がします。

一方、Salesforceはこれらの一括更新をするにはデータインポートウィザードやデータローダーを使ってCSVでそれぞれのレコードを入力する必要があり、移行作業の複雑さが増える傾向にあります。また一時テーブルを作るような操作も実質的に難しいので取れる選択肢が多くありません。なにかあったときにPITRやDBインスタンスから復元するといったこともできません。フルバックアップも厳しいです。また、オブジェクトが各機能と密結合だったり、影響範囲を特定する難易度が高かったりと、Webでは「難易度高い」案件もSalesforceでは「実質不可能」になることも少なくないです。

3. Apex/VF/LWCなどの開発・保守性が悪くなりがちな機能

Apex/VF/LWCいずれもプロプライエタリな技術なため、Webな人がコードを読みづらい、あるいはスキルポータビリティが低くなる傾向があります。

VF/LWCではReactなどの技術スタックで記述することが可能ですが、相当技術感度が高い組織じゃない限りは採用されていない気がします。²

Apex・Visualforce・LWC ・SOQL・ガバナなどの制約によりコードの保守性が悪くなる傾向もあります。ライブラリなどのエコシステムも育っているとは言い難く、Web開発よりは導入ハードルが高くなりがちです。

「実質的に」というのは頑張ればできるんだけど実用に向かないという意味です。 ↩︎
https://rajaraodv.medium.com/developing-react-redux-apps-in-salesforce-s-visualforce-3ad7be560d1c ↩︎

前提を変える力

Sat, 08 Nov 2025 22:20:00 +0900

前提を変える力って大事だなぁと、ふと思ったので駄文を書く。

前提を変えれないと戦略を間違う

アプリケーションコードに何百行・何千行の関数のような負債があったとする。そのアプリケーションにはテストコードがない。リファクタリングをしたいが、どうすれば良いか。

A. 頑張ってリファクタリングする。手動でテストをする。
B. アプリケーションを捨てて新規に作り直す。
C. 周辺のテストコードを書く。そしてリファクタリングする。

ご存知のとおりAやBは茨の道だ。もちろん状況によっては選択しても良い。ただ、Cという選択肢を検討せずにAやBを選択するのは良くない。 Cはテストコードを書くことによって「テストコードがない」という前提を変えている。

このように前提を変えれることを知らずに、あるいは前提を変えることを考えずに判断してしまうケースは多々ある。インフラを知らないエンジニアが、インフラで解決すべき課題をアプリケーション側で無理やり解決する、あるいはその逆のパターンはよくある話だ。

フルスタックとフルサイクル

前提を変えれるかどうかの勘所は経験やスキルに強く依存している。たとえばフロントエンドもサーバーサイドもインフラもわかるフルスタックエンジニアは前提を変えやすい。アーキテクチャを正確に理解し、解決手段の引き出しが多く、前提を変えれることを知っているからだ。

フルスタックでなくても、サーバーサイドエンジニアがフロントエンド・インフラ担当のエンジニアと密にコミュニケーションを取れれば、前提を変えることができる。企画・要件定義からリリース・分析・運用まで入れば、より大きく前提を変えることができる。これがフルサイクルエンジニアと呼ばれるロール・スキルなのだと思っている。

技術に依らない

そしてこれはエンジニアリングに依らない。ビジネス・組織・業務プロセスなどあらゆる領域で変えることができる前提がある。前提を変えるために必要なステップがある。それらの引き出しが仕事力と言われるものになるのだろうし、ビジネスを力強く推進できる能力になるのだと思っている。あるいはビジネスとは前提を変えることなのかもしれないなぁ、とか。

たたき台のお作法

Mon, 03 Nov 2025 22:25:00 +0900

物事を前に進めるうえで、たたき台を作るのは大事。

ということで、自分がたたき台を作る上で気をつけていることなどを雑に書いていく。

たたき台がなぜ必要なのか

単に最終決定に対する「原稿」の役割もあるが、それ以外にも

テキスト・図によって認識が揃いやすくなる。
認識が揃うことで議論が進みやすくなる。次にやるべきことが見えやすくなる。
作った人が思考が整理できる。

といった効果が期待できる。たたき台が無いと空中線になり、議論の前提や発言の意図を揃えることに時間を使い、議論が進みづらくなる。

何を使ってたたき台を作るか

タスクを洗い出すためのたたき台

Google DocsやWikiなどにタスクを一覧化して書いてみる。Google Docsだとコメントを入れられるので議論しやすいが、最終的な決定を追いづらいのでそれはWikiに残しておくと良さそう。ちなみにタスク以外にも議題を予め書いておくのも「たたき台」だと思っている。

要件定義のためのたたき台

何か新しい画面やアプリケーションを提供するのであればfigmaやmiroなどのツールを使って画面・フローを書いてみて、それを共有し認識を揃えたり課題点を洗い出していく。最近では生成AIを使って簡単にデモアプリケーションを作成できるので、そういったものを使って動くたたき台を作っていくのも良い。この段階のたたき台では「絵」が大事だったりする。

設計を議論するためのたたき台

要件定義で確定した画面や処理を実装するための詳細設計をしていくためのたたき台。テーブルやAPI定義、シーケンス図が主なたたき台・成果物になっていく。

API定義はwikiやOpenAPI、実装からAPI定義を記述できるものは簡易実装でも良い。テーブル定義もwikiや実際のマイグレーションコードでたたき台を作っていく形になる。シーケンス図は draw.io を使うと簡単に記述できる。「絵」や「表」をメインにしつつ文字列で詳細を補足していくイメージ。

作った「たたき台」を自分の言葉で話せるようにする

生成AIがこういうの出してきました！で、自分の脳を通さずにたたき台を出すのはダメ。自分の言葉で話せることが大事。初版は自分で作って、観点が足りないかどうかを生成AIにレビューしてもらうのが良さそう。

作った「たたき台」にこだわらない

たたき台なので、やっぱ全然違うとなって全部破棄されたとしても気にしない。認識を揃えるのに価値が有るので破棄されることはどうでも良い。

細部にこだわらない。スピードが大事

議論を進めるためのものなのでスピードが大事。議論の中で細部を補足したり決めていけば良い。

ビジネスモデルと労働集約

Mon, 03 Nov 2025 22:00:00 +0900

ビジネスモデルと労働集約について考えを書いてみた。いちエンジニアの戯言です。

IT業界におけるビジネスモデル

IT業界における受託開発とSaaSのような自社サービスを例に出して考えてみる。

受託開発は、営業が案件を受注し、請負契約を結んで成果物を納品して売上が発生する。保守のような売上が毎月発生するような場合もあるが、基本的に新規案件・追加案件の受注と納品が売上の源泉になる。ということは、営業が案件を受注することも大事だし、デリバリーする部隊も大事ということで、「人」が軸になってくる。管理コストなどはさておき「人」を増やせば利益が上がる、まさに労働集約型のビジネスと言える。納期やコストを守り、品質の高いシステムを納品した結果、利益率や売上が上がるかもしれないが、トップラインを継続的に上げていくには「人」や「単価」を上げていくしかないように思える。

SaaSの自社サービスだと、営業が案件を受注するところは同じだが、サービス利用費（初期・月額）として毎月売上が発生するのが違う部分だ。売上が継続的に発生するため、仮にチャーンレートが0%であれば追加の営業をしなくても売上が発生するし、システム保守・運用費も受託開発などの初期構築費用と比べると低コスト・低リスクなため、「システム」が重要になる。システムが安定的に動いたり、継続的な機能改善を行っていくことでチャーンレートが下がり、売上貢献につながる。受託開発と比較すると労働集約性は低くなる。
とはいえ、チャーンはある程度発生するし、トップラインを伸ばすためには営業は引き続き重要だ。ほとんどのSaaSがSales Led Growthだ。継続して利用していただくためにはカスタマーサクセスやカスタマーサポートのような組織も必要になってくるかもしれない。ということで引き続き「人」は大事なのである。

このようにビジネスモデルがある程度「労働集約性」を決定づけてしまうように思えてきていて、ビジネスモデルの重要性を感じていたりする。

ソフトウェアエンジニアとしてこれをどう解釈して動いていくべきか

とはいえビジネス・ビジネスモデルを自分がどうこうできる感じでも無い。なんか良いアイデアがあるわけでもなく、正直あったとしても遂行できる感じもしない。

ということで、戦術であるところの「システム開発」を一生懸命頑張っていくしか無くて、質の高い課題を解決して、利益を出せる体質にするのがエンジニアとしての責務とも思う。エンジニアリングのケイパビリティを上げていくことは、新しいビジネスを作っていく上でも重要なはずだ。

また「労働集約」は悪いことではないと思っている。ビジネスを成り立たせるには結局「人」が一番大事、ということなのかもしれない。その上で、レバレッジの効きやすいエンジニアリングをどう活かしていくかを各組織・各プロダクトでゼロベースで考えていく必要がある。

余談

必要とされるスキルや技術もこのビジネスモデルに左右されていそうな気がする。受託開発はデリバリーが大事なので初期開発スキルやプロジェクトマネジメントスキルが必要になり、自社サービスは保守が大事なので運用保守の開発スキル、継続的デリバリーといったスキルが必要になる。技術も浅く広くなのか、深く狭くなのか、という違いも出てくる。

DBテストのデータ管理はトランザクション/ロールバック方式にしたい

Sat, 01 Nov 2025 22:25:00 +0900

自動テストにおいて、信頼性を上げるためにDBはモックではなく実際のDBを使ってテストをしたい。

その場合、データ管理はテストケースの都度

データベース・テーブルを再作成（DROP/CREATE）する
テーブルデータを再作成（DELETE/TRUNCATE/INSERT）する
テスト開始前にトランザクションを開始し、テスト終了後にロールバックする

といった方法を取っていることが多いと思う。

この方式で 3 のトランザクション/ロールバック方式のデータ管理の採用を第一に検討すべきだよね、という話を書いていく。

理由1: 高速である

DROP/DELETE/TRUNCATE/CREATEは実行コストが高く、一般的には遅い操作となる。インメモリDBを使う方法もあるが、言語やライブラリの実装に強く依存するし、結局マイグレーションにコストがかかりがちだ。

その点、トランザクション/ロールバック方式は一般的な高速な操作であり、テスト時間が増えがちなDBテストにおいては大きなメリットだ。

理由2: 並列性が高い

トランザクション分離レベルに依るが、ダーティリードでなければトランザクション内に作成されたデータは他のトランザクションから見ることができないので、トランザクション/ロールバック方式は並列実行がしやすい。

他の方式だと並列に実行する場合はデータベースを予め作成する必要があるし、並列数＝データベース数となってしまう。

理由3: データのcleanupが簡単

トランザクション/ロールバック方式であればロールバックするだけでデータがリセットされる。そのためテストの安定性も上がりやすい。

他の方式だと、データベースやデータのcleanupを明示的に行う必要があり、やや面倒だし安定性も下がりがち。

各言語/フレームワークでは何を使うか

PHP/Laravelでは DatabaseTransactions トレイト
TypeScript/Prismaでは Quramy/jest-prisma
Goだと DATA-DOG/go-txdb

あたりを利用することになりそう。

ライブラリによってはトランザクションのネストに対応しておらず、結果としてアプリケーションのトランザクション処理に対応できないケースがあるので選定するときには注意が必要。

[小ネタ] Laravelではdisplay_errorsはOffになる

Thu, 23 Oct 2025 21:40:00 +0900

Laravelではテスト環境以外ではdisplay_errorsが自動でOffになります。

if (! $app->environment('testing')) {
 ini_set('display_errors', 'Off');
}

https://github.com/laravel/framework/blob/570c154e7970193862b5c12bc13c3393e42949a1/src/Illuminate/Foundation/Bootstrap/HandleExceptions.php#L56

その代わり set_exception_handler や set_error_handler を使ってcatchされていないExceptionが適切にハンドリングされます。

PHPStan導入・運用ガイド

Tue, 21 Oct 2025 22:25:00 +0900

どの会社でも同じようなwikiを書いているので、ここにまとめておきます。

PHPStan とは

PHPの静的解析ツールで、コードを実行せずにコードを検査できます。具体的には未定義変数・関数・メソッド・プロパティ・クラスへのアクセス、引数の数・型の間違い、未使用変数・引数・useパラメータ、戻り値の型の不整合など様々なエラーを検知できます。

例えば以下のようなコードを実際に動作させることなくエラーを検知できます。

class Hoge
{
 public function someMethod(int $someArg): string
 {
 echo $nodefined; // Undefined variable: $nodefined.
 $tmp1 = new NoExist(); // Instantiated class NoExist not found.
 $tmp2 = noFunction(); // Function noFunction not found

 return 1; // Method Hoge::someMethod() should return string but returns int.
 }
 private function privateMethod() {}
}

$hoge = new Hoge();
echo $hoge->fuga; // Access to an undefined property Hoge::$fuga
echo $hoge->hello(); // Call to an undefined method Hoge::hello().
echo $hoge->someMethod(); // Method Hoge::someMethod() invoked with 0 parameters, 1 required.
echo $hoge->someMethod('123'); // Parameter #1 $someArg of method Hoge::someMethod() expects int, string given.
echo $hoge->privateMethod(); // Call to private method privateMethod() of class Hoge.

エラー検知例 https://phpstan.org/r/cc1142d9-4418-4c88-8848-9aa10c1e3753

Rectorの使い方とサンプル

Tue, 21 Oct 2025 22:00:00 +0900

どの会社でも同じようなwikiを書いているので、ここにまとめておきます。

Rectorとは

PHPの自動リファクタリングができるツールです。

フレームワークのアップグレードによるコードの書き換え、自動型付けなどで活用できます。

使い方

パッケージインストール

$ composer require rector/rector --dev

実行（設定ファイル rector.php が存在しない場合は作成される）

$ vendor/bin/rector

Laravel用のRectorプラグイン

$ composer require driftingly/rector-laravel --dev

https://github.com/driftingly/rector-laravel

rector.phpサンプル

自動で型付けしたい

<?php

declare(strict_types=1);

use Rector\Config\RectorConfig;

return RectorConfig::configure()
 ->withPaths([
 __DIR__ . '/app',
 ])
 ->withImportNames(importShortClasses: false)
 ->withTypeCoverageLevel(0);

typeDeclarationsを有効にすると以下のRectorルールが適用されます。 https://getrector.com/find-rule?rectorSet=core-type-declarations&activeRectorSetGroup=core

withTypeCoverageLevelで段階的な適用もできます。 https://getrector.com/documentation/levels

withImportNamesを入れるとuseも適切に付与してくれます。 https://getrector.com/documentation/import-names

旧Factoryから新Factoryに移行したい

古いLaravelからバージョンアップするとき限定ですが…

<?php

declare(strict_types=1);

use Rector\Config\RectorConfig;
use RectorLaravel\Set\LaravelSetList;

return RectorConfig::configure()
 ->withPaths([
 __DIR__ . '/app',
 ])
 ->withImportNames(importShortClasses: false)
 ->withSets([
 LaravelSetList::LARAVEL_LEGACY_FACTORIES_TO_CLASSES,
 ]);

参考: https://zenn.dev/zatsuyooo/articles/laravel7-to-8

ルーティングの記述方法を配列方式に変更

routes.php で 'UserController@index' の形式から [UserController::class, 'index'] の形式に変更したい場合に使う

<?php

declare(strict_types=1);

use Rector\Config\RectorConfig;
use RectorLaravel\Rector\StaticCall\RouteActionCallableRector;

return RectorConfig::configure()
 ->withPaths([
 __DIR__ . '/routes',
 ])
 ->withImportNames(importShortClasses: false)
 ->withConfiguredRule(RouteActionCallableRector::class, [
 RouteActionCallableRector::NAMESPACE => 'App\Http\Controllers',
 ]);

Next.jsのServer ActionsでCloud Tasksを呼び出すときはバンドル対象から除外する

Mon, 20 Oct 2025 22:50:00 +0900

Next.jsのServer ActionsでCloud Tasksを呼び出したときにエラーになったのでメモ。

具体的には以下のような感じでCloud Tasksを呼び出すとエラーになってしまった。

import { CloudTasksClient } from "@google-cloud/tasks";

export default function Home() {
 const handle = async () => {
 "use server";
 const client = new CloudTasksClient();

 await client.createTask({
 parent: queueName,
 task: {
 httpRequest: {
 // ...(snip)...
 },
 },
 });
 }
 return (
 <button onClick={handle}>Click Me</button>
 );
}

発生したエラーは以下の通り

Cannot find module '/path/to/my-app/node_modules/@google-cloud/tasks/build/esm/src/v2/cloud_tasks_client_config.json'

webpackでビルドされるとき cloud_tasks_client_config.json が読み取れなくなっているのが原因のようなので、以下のような感じで next.config.ts の serverExternalPackages に指定することで、バンドル対象から除外されてnode_modules配下のファイルを読み込んでくれるみたいです。

{
 serverExternalPackages: ["@google-cloud/tasks"],
}

https://nextjs.org/docs/app/api-reference/config/next-config-js/serverExternalPackages

ちなみに aertje/cloud-tasks-emulator で @grpc/grpc-js を使っている場合、同様の理由で

[TypeError: Channel credentials must be a ChannelCredentials object]

というエラーが発生するので、こちらも追加すればOK

{
 serverExternalPackages: ["@google-cloud/tasks", "@grpc/grpc-js"],
}

NextAuth.jsで代理ログインを実装する方法

Mon, 20 Oct 2025 22:00:00 +0900

認証があるアプリケーションを実装しているとき、動作確認を行うため他のユーザになりすましてログインする「代理ログイン」をしたくなることがある。 NextAuth.js を認証基盤として利用している場合は、カスタム認証プロバイダとして代理ログイン用の処理を実装することで実現できる。

PrismaをORMとして使っている場合は以下のようなカスタム認証プロバイダで実装すれば良い。

import CredentialsProvider from "next-auth/providers/credentials";
import { prisma } from "@/lib/prisma";
import { logger } from "@/lib/logger";

// IDを指定するだけでログインできる認証プロバイダ
export const impersonateCredentialsProvider = CredentialsProvider({
 id: "impersonation",
 name: "Impersonation",
 credentials: {
 targetUserId: { label: "Target User ID", type: "text" },
 developerUserId: { label: "Developer User ID", type: "text" },
 },
 async authorize(credentials) {
 // 必要に応じて環境・権限チェック 
 // if (process.env.NEXT_PUBLIC_APP_ENV === "production") {
 // return null;
 // }
 
 // バリデーション 
 if (!credentials?.targetUserId) {
 return null;
 }

 try {
 const targetUser = await prisma.user.findUnique({
 where: { id: credentials.targetUserId },
 });

 logger.info(
 `Developer ${credentials.developerUserId} impersonated user ${targetUser.email}`,
 );

 return {
 id: targetUser.id,
 email: targetUser.email,
 name: targetUser.name,
 image: targetUser.image,
 impersonatedBy: credentials.developerUserId,
 impersonatedAt: Math.floor(Date.now() / 1000),
 };
 } catch (error) {
 logger.error("Impersonation authorization error:", { error });
 return null;
 }
 },
});

認証プロバイダの設定はこんな感じで環境変数を見て切り替える。以下では本番環境では代理ログインプロバイダを無効化している。

Cloud RunでCloud SQL接続するときは接続待機が必要

Mon, 20 Oct 2025 21:45:00 +0900

Cloud Run JobsでCloud SQL接続 ( /cloudsql/{instance_connection_name} のUDSを使った接続）を使っている場合、アプリケーションコードからすぐに接続すると以下のような接続エラーが発生するときがある。

Can't reach database server at /cloudsql/{project}:{region}:{instance}:5432
Please make sure your database server is running at /cloudsql/{project}:{region}:{instance}:5432.

検証したところ立ち上がり時の接続のタイムラグがありそうだったので、DB接続待ちのコードを入れれば解消できる。例えば、Node.js / Prismaを使っている場合は、以下のようなコードをアプリケーションコードの事前処理に入れればOK。

async function waitForDB() {
 const retry = 10; // retry count
 const interval = 5000; // retry interval in milliseconds
 
 for (let i = 0; i < retry; i++) {
 try {
 logger.info(
 `Attempting to connect to DB (attempt ${i + 1}/${retries})...`,
 );
 await prismaClient.$queryRaw`SELECT 1`;
 logger.info("Successfully connected to the database!");
 return;
 } catch (error) {
 const errorMessage =
 error instanceof Error ? error.message : String(error);
 logger.error(`Failed to connect to DB: ${errorMessage}`);
 if (i < retries - 1) {
 logger.info(`Retrying in ${interval / 1000} seconds...`);
 await new Promise((resolve) => setTimeout(resolve, interval));
 } else {
 logger.error("Max retries reached. Could not connect to the database.");
 throw error; // 全ての試行が失敗したらエラーをスロー
 }
 }
 }
}

async function main() {
 await waitForDB();
 
 // アプリケーションコード ...
}

ロールをあえて決めるかどうか

Sun, 19 Oct 2025 23:50:00 +0900

全員がプロダクトの責任を持ったりステークホルダーとのコミュニケーションを等しく行うという意味で リード という役割を決めずにフラットに進めていったものの、責任者・判断する リード を決めたほうが効率的に進むことがあったりする。

フルスタックにバックエンドもフロントエンドもインフラも全部やろう、と進めたものの、インフラ側まで手が回らず、結果としてインフラ担当チームに依頼して進めた方が効率的に進むこともある。フルスタック・フルサイクルにできるエンジニアは実際にほとんどいなくて、各領域で中途半端になって、あまり良くない実装・設計になることもある。そんなわけで、現実的には インフラチーム データ分析チーム といった感じでチーム・ロールを分けることが多いと思う。

チーム内の ロール において、あえて決めずに行う理想形はありつつも ロール を決める現実解になりがちだし、組織内の チーム においても、チームを分けない理想形はあるけど現実的には分けざるを得ないケースが多いと思う。どちらも必要なスキルが不足していることに起因していそうだけど、実際そのスキルを身につけるには結構たいへん（採用も教育もたいへん）なのである。

ということで個人的にはロールやチームを分けざるを得ないと思っていて、それによって責任の所在が明らかになり物事が進んだりする。一方でサイロ化や無関心みたいなことも発生しがちなので、チームを分けたときの「チーム間共有」、ロールを分けたときの「チーム内共有」といった工夫が必要になる。やっていることを知っているという透明性が大事で、それがある意味フルサイクルになる、的な。

Laravelのconfig()のカスタム値は環境依存の値にすべき

Sun, 19 Oct 2025 22:15:00 +0900

Laravelのカスタムのconfigで環境に依存しない固定値やenum値を書いているコードを見たことがあるが、標準で用意されていないカスタムの値に関しては環境依存の値にすべきである。

理由としては

config() 値の型解釈や補完はプラグインに依存する
config/*.php に値があるため、app/ 配下のコードと距離が遠くなりコードの保守性が下がる

の2点。

ということで、固定値であれば普通にその値に従属すべきモデルクラスのconstに定義し、enum値であればPHPのEnumを使えば良い。

逆に環境依存の値、例えば環境変数の値や環境に依存する値（APP_ENVに間接的に依存する値）は config で管理する。app/ のアプリケーションコードに env() を直接使うのはNGで config() を使うのが推奨されているというのが理由。

メッセージ配信系バッチ実装ガイドライン

Thu, 16 Oct 2025 21:50:00 +0900

どの会社でもバッチ実装系のガイドラインを書いている気がするので、もうここでまとめて参照させたいな、という意図で公開してみます。Laravelを想定して書いています。

[MUST] テストを書く

インシデント時の影響が大きいため、しっかりテストを書くことをオススメします。

メール送信の場合は Mail ファサードを使っている場合は簡単にテストが書けます。それ以外の場合（ショートメッセージなど）はモックが出来るようにモジュールをDIしておくと簡単にテストできます。

[MUST] dry runできるようにする

dry runオプションで実際にメールなどが飛ばないように実装することで、開発・テスト環境でも安心して検証が可能です。本番環境においてもdry-runで送信対象が間違っていないかを確認できて安心です。

実装イメージ

$dryRun = $this->option('dry-run');

foreach ($customers as $customer) {
 // ...(省略)...
 
 if ($dryRun) {
 Log::info("送信対象: xxxx, 本文: xxxx");
 continue;
 }
 Mail::to(...)->send(...);
}

[SHOULD] 誰に送信したのかをIDなどでロギングしておく

不具合が発生したときなど誰に送信したのかをトレースできる仕組みがあると便利です。

foreach ($customers as $customer) {
 // ...(省略)...
 
 \Log::info("送信対象: {$customer->id}");
 \Mail::to(...)->send(...);
}

[MUST] 初回稼働時は実行に立会ってログの確認を行う

メール送信のインシデントは緊急性が高い可能性があるため、初回稼働時は可能な限りバッチ実行に立会ってログや動作の確認を行ってください。

[SHOULD] 本番・テスト環境で処理を差し替える

メッセージを送信するクラスを共通化した上で、送信する処理を本番環境とそれ以外の環境で処理を差し替えると、本番環境以外ではメッセージが送信されません。

if (app()->environment() !== 'production') {
 // ロギングや別の送信チャンネルに切り替え
 \Log::debug(...);
} else {
 // メッセージ送信処理
}

上記の例だと、実際の送信テストは本番環境でしかできないことに注意してください。

開発サーバーではMailのドライバーをlogにする

メール送信の場合は、Mailのドライバーをlogに変更すると、間違って送信してもログに吐かれるだけなので安全です。

MAIL_DRIVER=log

テキストメールの場合は実際にメール送信するより検証が容易かもしれません。

ローカル開発環境では mailpit などのテストツールを使えば良いと思います。

[MUST] ホワイトリスト方式のチェックを入れる

上記の 環境による処理差し替え との合わせ技になりますが、開発環境においては、事前に環境変数で定義した宛先のみメッセージを送信できるようにすると安全にテストができます。

$arrowList = config('message.allow_list', []);
if (app()->environment() === 'production') {
 // メッセージ送信処理: 本番用
} else if (in_array($to, $arrowList, true)) {
 // メッセージ送信処理: 開発用
} else {
 // エラー or ロギング
}

[MUST] API呼び出しの共通パラメータを環境変数化して切り替え

API経由でのメッセージ送信であればAPIエンドポイント（ホスト名）やAPIキーを環境変数化しておきます。

Laravelの各環境を視覚的に判別する

Wed, 15 Oct 2025 21:20:00 +0900

Rubyで言うところの rack-dev-mark 的なものをLaravelで実装したメモ。パッケージもいくつか見つかるけどサクッと実装できてカスタマイズもしやすいので自前でやってみた。

具体的には以下のようなミドルウェアを書いてwebなルートに適用すれば良い。

namespace App\Http\Middleware;

use Closure;

class DevMark
{
 public function handle($request, Closure $next)
 {
 if (app()->isProduction()) {
 return $next($request);
 }

 $response = $next($request);

 $this->modifyResponse($response);

 return $response;
 }

 private function modifyResponse(mixed $response): void
 {
 $content = $response->getContent();

 $env = strtoupper(app()->environment());

 $renderedContent = <<<HTML
<style>
 #devmark {
 left: 10px;
 top: 10px;
 position: fixed;
 padding: 5px 8px;
 z-index: 100;
 background-color: green;
 color: white;
 border-radius: 0.5rem;
 display: flex;
 align-items: center;
 justify-content: center;
 font-size: 0.8rem;
 font-weight: 900;
 box-shadow: 0 1px 2px 0 rgba(0, 0, 0, 0.3);
 }
</style>
<div id="devmark" onclick="this.style.display = 'none';">{$env}</div>
HTML;

 $pos = strripos($content, '</body>');
 if ($pos !== false) {
 $content = substr($content, 0, $pos) . $renderedContent . substr($content, $pos);
 } else {
 $content = $content . $renderedContent;
 }

 $response->setContent($content);
 $response->headers->remove('Content-Length');
 }
}

こんな感じで表示されてクリックすると非表示になる。

MVCでええやん

Mon, 13 Oct 2025 21:50:00 +0900

フルスタックフレームワークでMVCのアーキテクチャを採用しているものは多い。一方でレイヤード？ヘキサゴナル？オニオン？アーキテクチャを採用しているサービスも増えているように思う。

個人的にはWebアプリケーションのほとんどのケースはMVCパターンで十分だと思っているのだが、今回はこのあたりの話を書いていく。なお、PHP/Laravelを例として記述していく。

MVCを使うときの大まかな設計の流れ

実装内容の難しさによってどういった構成に着地するか変わってくるが、概ねこんな感じで考えている。

基本形（バリデーション＋保存）

管理画面のマスタ管理など純粋なデータの作成・更新で使うようなパターン。

class UserRegistrationController
{
 public function store(Request $request)
 {
 $attributes = $request->validate([
 'name' => 'required|string|max:255',
 // ...
 ]);
 $user = User::create($attributes);
 return redirect()->route('users.show', $user);
 }
}

このパターンに収まるケースはそこまで多くないので、以降でロジックが増えてきたときのパターンでの構成を書いていく。

バリデーションが増えてきたら…

FormRequestクラスにバリデーション処理を移行する。

class UserRegistrationController
{
 public function store(UserRegistrationRequest $request)
 {
 $user = User::create($request->validated());
 return redirect()->route('users.show', $user);
 }
}

保存時の変換ロジックなどが増えてきたら…

Modelにメソッドを生やす

class UserRegistrationController
{
 public function store(UserRegistrationRequest $request)
 {
 $user = User::register($request->validated());
 return redirect()->route('users.show', $user);
 }
}

このModelのユースケースが限られている場合は create 系のメソッドも増えないため、Modelに実装しちゃっても良いというケース。

もっと固有のロジックが増えてきてModelが太ってきたら…

FormクラスやWebのアクションに対して別のEntityを見出してクラス化し、そこにロジックを入れる。

class UserRegistrationController
{
 public function store(UserRegistrationRequest $request)
 {
 $form = new UserRegistration($request->validated());
 $user = $form->save();
 return redirect()->route('users.show', $user);
 }
}

このFormクラスに該当するクラスをUsecaseクラスやServiceクラスとして定義して利用しているプロジェクトもあると思う。ただ、ServiceクラスもUsecaseクラスも曖昧なまま利用されがちなので、利用する場合はチーム内でよく話し合ったほうが良い。例えばコントローラーから複数のServiceを呼び出したり、ServiceがServiceを呼び出したり、あるいは外部サービスに対するアクセス層としてServiceを定義したりするケースもある。そうすると、どこに記述すればよいのか、どこを読めばよいのか曖昧になり保守性が下がる。

純粋なモデリング＝Entityを見出すことができるのであればModelを定義してそこから依存するModelを呼び出したり外部アプリケーションへの通信（メールやHTTP APIなど）をすれば良い。

ちなみにFormクラス相当を作る場合でも↓こんな感じでModelディレクトリに切るのが好きです。

app/Models/User/Registration.php

Fat Controllerでもええやん

感覚的に100行くらいの処理であればModelにロジックを切らなくてもトランザクションスクリプトな感じで実装してもあまり問題ないように思う。
テストが書かれていればリファクタリングも容易だし、100行くらいであればあちこちファイルを移動する手間もなくなり保守性としても良くなりそう。

過度にFat Controllerを怖れる必要はない。最初はFat Controllerで保守性厳しいなぁと思ったら適宜切り出せば良い。
同様にFat Modelの方もまずは一旦単一のModelに入れてみて、保守性が悪くなってきたと感じたタイミングでFormや他のModelクラスに切り出せば良い。保守性が悪くなることにはドメイン理解も進んでいるはずなので状況的にも切り出しやすくなっているように思う。

いずれにしてもコントローラをテストできるFeatureテストの実装はとても大事。LaravelはFactoryやモックあたりも含めてとてもテストが書きやすいので正常系だけでも書いておくと良い。

そのデータソース切り替えは本当にあるのか？

Repositoryで層を切っているとデータソースの切り替えがしやすいよね、と言われることがある。たしかにRepositoryの中のコードをいじれば二重書きなどができるようになるので変更は楽なように思える。

拡張性よりスピード感を大事にしたい

Sun, 12 Oct 2025 20:40:00 +0900

「拡張性を考慮して」というワードをよく聞くが、その拡張する機会が訪れなかったり、想定していた拡張性と違っていたり、そもそも実装の筋が悪かったり、拡張性を考慮したことによりコードが保守しづらくなる、といった結果になったことも少なくない。

例えば、こういった経験をしたことがあったりする。

他の認証方式を追加するかもしれないからと思って拡張できるように作ったものの、認証方式は追加されなかった
拡張性を考慮して管理画面で変更できるパラメータを増やしたが、あまり使われなかった
データストレージを切り替えるためのリポジトリ層を用意したがデータストレージを切り替える機会がないまま終わる
↑でデータストレージを切り替える機会があったもののリポジトリ層の抽象化の仕方が良くなくて、結局リポジトリ層を導入していないコードと同じくらいの労力がかかってしまった
拡張性を考慮して抽象に対して実装したが、その拡張性を使う機会が全くなかった
拡張性を考慮してマイクロサービスにしたが、その拡張が必要な規模にならず、分断されたモノリスになってしまったり、保守性が下がってしまった

ということで、拡張性を大事にしすぎるのも考えものだなぁと思っていたりする。個人的にはそれよりもスピード感持って今の課題を解決していく方が大事なんじゃないかなとか思ったりしたので以下、駄文を書く。

その拡張性の効果が出るのは「いつ」か？

1〜2ヶ月以内くらいに機能実装する予定なのか、半年後くらいなのか、1年以上あとなのか、というのでも結構変わってくる。その拡張性の効果が出るのは「いつ」か、と言い換えても良いかもしれない。

たとえば半年後、1年以後の効果を見込んでいる場合には、状況がかなり変わっている可能性が高く、その拡張性のニーズも変わっているかもしれない。逆に1〜2ヶ月以内であればそれなりにニーズが高い機能であり優先度としても高いため、拡張性を考慮した実装にしてもその実装が無駄になることは少ないように思う。

そのときに変更できるのか？という判断軸

その拡張に対応するときに現実的な工数で対応できるのであれば、「いますぐ」に拡張性のある実装をする必要はないかもしれない。その場合、ある程度実装方法のあたりを付けておいて「そのとき」が来たら一気に対応する、という感じになる。

DBに関しては変更がしづらい代表格なので、もちろんある程度拡張性を考えても良いのだが、現状で参照・更新箇所が少なかったり使われ方の拡張性が見えづらいテーブルに関しては過度に考える必要はないかもしれない。
データ数がそこまで多くなく、影響範囲なども含めたマイグレーションプランも立てやすいものであれば一旦管理が楽な方に振り切って、ある程度見えてきた段階で変更する感じがリスクが少ないように思える。
とはいえ、このあたりの判断の閾値はチームの経験や腕力に強く依存するということも付け加えておく。

いずれにしても実装時に 将来的な変更を予想してみて、それが来たときにどういう変更をすればよいのか を考えるのが大事なように思う。
「変更できるようにする」するのではなく、「変更を想定しておく」だけで良い。

拡張性よりもスピード

ということで下手に拡張性を考えすぎて開発が遅れるよりは、拡張性は考慮しつつも現状の課題を解決するリリースをサクッとやってしまうのが良いと思っている。

そのリリースをすることでフィードバックが得られ、未来にやるべきこと＝拡張の方向性が見えてくる。もし拡張が必要であればサクッとリリースしたことによって余った時間と想定していた変更方法を使ってサクッと拡張していけば良い。

言い換えると 決定を遅らせる という話なんだけど、決定を遅らせるために抽象化して中小に対して実装するというような話ではなく、現在の課題を解決し、ちょっと先の不確実性の高い未来に対応できるためにも今やるべきことをうまくやっていきましょうという話なのかも。

useEffectのdependenciesに配列値を指定している場合の挙動

Sat, 11 Oct 2025 21:25:00 +0900

useEffectに配列値を指定している場合に、意図せず再評価されるケースが合ったのでメモ

useEffectのdependenciesと配列値

以下のようなコードで、setValueで値が変更されて子コンポーネントが再評価されるとき、デフォルト引数の配列も再度生成されて参照が変わるため useEffect() が再度評価される

function Hoge({ items = [] }: { items?: number[] }) {
 useEffect(() => {
 console.log(items);
 }, [items]);
 
 const [value, setValue] = useState('');
 return (
 <input
 value={value}
 onChange={(e) => setValue(e.target.value)}
 />
 )
}

export default function App() {
 return (
 <Hoge />
 )
}

呼び出し元で固定の配列を指定すると子コンポーネントの再評価時でitemsの参照が変わらない。

export default function App() {
 return (
 <Hoge items={[]}/>
 )
}

ただ、親コンポーネントが再評価されると、毎回新しい配列が生成されて参照が変わってしまう。

export default function App() {
 const [value, setValue] = useState('');
 return (
 <>
 <input
 value={value}
 onChange={(e) => setValue(e.target.value)}
 />
 <Hoge items={[]} />
 </>
 )
}

なので関数の外側でconst定義したものを固定配列として渡すと参照が変わらないのでuseEffectが再度実行されない。

const defaultItems: number[] = [];

export default function App() {
 return (
 <Hoge items={defaultItems}/>
 )
}

ちなみにプリミティブは大丈夫

function Fuga({ number = 1, string = '2', boolean = true }: { number: number, string: string, boolean: boolean }) {
 useEffect(() => {
 console.log(number, string, boolean);
 }, [number, string, boolean]);
 
 const [value, setValue] = useState('');
 return (
 <input
 value={value}
 onChange={(e) => setValue(e.target.value)}
 />
 )
}

ということでこの問題は配列だけではなくオブジェクトや関数でも発生する。 constや外部関数などで参照を固定化しておくか、useMemoやuseCallbackなどでメモ化すれば良い。ただし、useMemo, useCallbackに関しては依存配列が結局その配列・オブジェクト・関数になりがちなので、結局useEffect()の依存配列に入れない、という選択肢になりそう。

ReactでEnterキーでサブミットする方法

Sat, 11 Oct 2025 15:00:00 +0900

フロントエンドのメモ書き。

結論としては極力formタグを使ったほうが良さそう。

formタグを使う

推奨パターン。

const App = () => {
 return (
 <form onSubmit={(e) => {
 e.preventDefault();
 // なんらかfetchしたりサブミットするコード
 }}>
 <input />
 </form>
 )
}

onKeyDownでEnterキーの処理する

IME予測変換のEnterでsubmitされないようにするため、 isComposing を使って予測変換中かどうかを判定しないといけない。が、Safariでは以下のコードではうまく処理できない。

import { useState } from 'react'

const App = () => {
 const [isComposing, setIsComposing] = useState(false);

 return (
 <input
 // nativeEvent.isComposingを使う以外にもonCompositionStart/EndでもOK
 // onCompositionStart={() => setIsComposing(true)}
 // onCompositionEnd={() => setIsComposing(false)}
 onKeyDown={(e) => {
 if (e.key === "Enter" && !e.nativeEvent.isComposing) {
 // なんらかfetchしたりサブミットするコード
 }
 }}
 />
 )
}

非推奨ではあるが e.keyCode を使うとisComposingなしで動く＝Safariでも動く

const App = () => {
 return (
 <input
 onKeyDown={(e) => {
 if (e.keyCode === 13) {
 // なんらかfetchしたりサブミットするコード
 }
 }}
 />
 )
}

依存パッケージのLICENSEを調べる方法

Thu, 09 Oct 2025 17:07:00 +0900

依存パッケージのLICENSEを調べる方法を雑に調べたのでメモ

PHP

composerに licenses サブコマンドがある

composer licenses

JavaScript

license-checker を使う

npx license-checker

Go

go-licenses を使う

インストール

go install github.com/google/go-licenses/v2@latest

実行

go-licenses report .

Python

pip-licenses を使う

インストール: uvの例

uv pip install pip-licenses

実行: uvの例

uv run pip-licenses

Ruby

LicenseFinder を使う

インストール

group :development do
 gem 'license_finder', require: false
end

bundle install

実行

bundle exec license_finder

Pushプレビュー画像の作り方

Thu, 09 Oct 2025 16:45:00 +0900

Web Pushを実装していて、Windows環境のPush通知のプレビュー画像が欲しくなった。自分はmacOSなのでWindowsを使っている人にキャプチャを依頼するのが正攻法だが、リリース前だったりして準備が大変そう。

キャプチャの正確性はそこまで必要なかったのでモック生成してくれるツールが無いかと思ったら https://onesignal.com/notification-preview というのがあって便利だった。OneSignalというプッシュ通知サービスが提供しているプレビューツールなので安心して使って良さそう。

こんな感じな画像を作成できる↓

SalesforceIDを15桁から18桁に変換するコード

Thu, 09 Oct 2025 15:30:00 +0900

ぱっと検索してもプログラム上で変換するコードが見つからなかったので…！

JavaScript version

function convertSalesforceIdFrom15to18(input) {
 let addon = "";
	for (let block = 0; block < 3; block++) {
		let loop = 0;
		for (let position = 0; position < 5; position++){
			var current=input.charAt(block * 5 + position);
			if(current >= "A" && current <= "Z")
				loop += 1 << position;
		}
		addon += "ABCDEFGHIJKLMNOPQRSTUVWXYZ012345".charAt(loop);
	}
 return `${input}${addon}`;
}

PHP version

function convertSalesforceIdFrom15to18(string $input): string
{
 $addon = "";
 for ($block = 0; $block < 3; $block++) {
 $loop = 0;
 for ($position = 0; $position < 5; $position++) {
 $index = $block * 5 + $position;
 $current = $input[$index];
 if ($current >= "A" && $current <= "Z") {
 $loop += (1 << $position);
 }
 }
 $checksum_chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ012345";
 $addon .= $checksum_chars[$loop];
 }
 return $input . $addon;
}

Go version

const checksumChars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ012345"

func convertSalesforceIdFrom15to18(input string) string {
	var addon string
	for block := 0; block < 3; block++ {
		loop := 0
		for position := 0; position < 5; position++ {
			charIndex := block*5 + position
			current := input[charIndex]
			if current >= 'A' && current <= 'Z' {
				loop += 1 << position
			}
		}
		if loop < len(checksumChars) {
			addon += string(checksumChars[loop])
		}
	}
	return input + addon
}

参考URL: Convert a 15-character Id to an 18-character Id

チームのための通知

Tue, 07 Oct 2025 23:25:00 +0900

SlackのGitHubアプリではGitHubリポジトリの通知を行うことができる。以前、この通知を個人DM向けに通知するのかチーム向けの通知チャンネルに通知するのか、という話があった。自分としては断然チームのチャンネルに通知すべきという意見なのだがその理由を書いてみる。

チームの開発状況はチームとして把握するべき

GitHubアプリではプルリクの作成、コメントなどが通知される。このコメントがオープンなSlackチャンネルに通知されることで、誰もがチームのレビュー状況や開発状況を把握できるようになる。ハマっているところがあればカバーしやすいし、そうでなくても今何に取り組んでいるのかがわかるとチーム感も生まれやすい。他の人のコメントも含めてやりとりを追うことも簡単で、議論の内容で気になったところがあれば良い意味で横槍を入れられる。

GitHubのWebページからプルリクを見れば良いという意見もあるかもしれないが、その場合はPULL型の情報アクセスになるため自発的に情報を取りに行かないといけなくなる。Slack通知はPUSH型なので受動的に情報を受け取りやすくなる。結構ここの情報取得コストの差が大きかったりするので「見てもらう」ことを促進するためにはPUSH型の方が良い。

個々人が設定するオンボーディングコストがなくなる

いちいちGitHubアプリの設定をするのはオンボーディングする側もされる側も面倒。人によって通知設定が変わってしまい良い意味での強制力もなくなってしまう。また、オンボーディングとしても過去のプルリクややりとりを追いやすくSlack検索もできるので便利ですよね。

これらはGitHubの通知に限らない

チーム開発に関係するやりとりは基本的にオープンかつディスカッションができるところでやるべきだと思う。また、やりとりの履歴もドキュメントを単に「公開する」だけではなくてちゃんとドキュメントがある旨を伝えるPUSH型のオープンネスが大事。階層が整備されていたり置くだけで特定の人に通知が来るような仕組みであれば明示的に伝える必要はないかもしれないが、そんな環境はほぼ無いと思うので、ちゃんと伝えていくのが大事。

「目の前の仕事に向き合って成長する」のもスキルの１つ

Mon, 06 Oct 2025 23:50:00 +0900

目の前の仕事に向き合うことで成長する、というのはよく言われていることだし、自分もそうだなと思っている。ただ、この「目の前の仕事に向き合う」というのは結構解釈が変わってくると言うか、向き合っているのに成長する人と成長しない人が分かれるような気がする。つまり、「目の前の仕事に向き合って成長する」のもスキルが必要ということ。

ということで、目の前の仕事に向き合って成長するには具体的にどういうアクションが必要なのか、というのを雑に書いてみる。

課題の本質を深堀りする

これは技術でも非技術でも大事。

技術においては例えば不具合が発生したときに、アプリケーションコードだけではなくライブラリのコードを読んだり、デバッグしたり、デバッグできるような仕組みを整えたりするスキルである。不具合の真因を理解することで次に同じような事象が発生したときも対応しやすく、原理を理解しているので応用が効きやすい。コードを書くときにも仕組みを理解しておくと罠にハマりづらい。

非技術においては、本質的な課題やドメインを理解することで、より価値のあるプロダクト開発ができるようになり、結果として成長につながる。ステークホルダーとのコミュニケーションもソフトスキルの成長機会になるかもしれない。

課題解決方法を模索できる

「コードを書く以外の解決方法がないのか」「ライブラリを利用できないか」「フレームワークの機能はないのか」「自前で実装するとしてもどう書けば効率的なのか」「他の言語やフレームワークではどうやって解決しているのか」「他のチームや会社ではどうやっているのか」など課題の解決方法に関しても模索・深堀りできると成長できる。技術的な引き出しの広さと深さを高めていくプロセス。

振り返りをする

良かったこと・悪かったことを自分なりに振り返って次のアクションに繋げるというのは大事。

例えば何も振り返りせず淡々と目の前の仕事を こなす だけでは、仕事の質は上げづらい。同じような仕事をこなすスピードは上がるし、ステークホルダーとのコミュニケーションもこなれてくるので信頼されてお互い気持ちよく仕事できてしまうのだが、本質的な課題を解決できてなかったり、ジリ貧な状態になりやすい。

仕事のちゃんと成果を振り返ると、質とスピードを上げつつ、それをスケールさせる方法を模索・試行することができる。前回とは違う方法で仕事にアプローチすることで、それが結果的に成長につながる。

チームとしてスキルを持つ

Sat, 04 Oct 2025 22:30:00 +0900

エンジニアってやるべきことが多いなぁと思います。

粒度を雑に書いていくと

要件・要求の把握
ドメイン理解
短・中・長期を見据えた設計
実装（固有技術の習得）
- フロントエンドもバックエンドもDBもインフラも…
チームへの共有・ドキュメンテーション
ステークホルダーコミュニケーション
自動テスト・CI/CDなどの基盤整備
オブザーバビリティ
セキュリティ
チーム開発
コードを書かない技術

などなどなど。１つのスキルを深堀りするだけでもかなりの時間を要し、チームやプロダクトによっては経験できないものもあったり、そもそも得意不得意があったりします。

エンジニアとして練度が上がってくるともちろんこういったことが身についてきて良い感じに課題解決できるようになるわけですが、とはいえ認知負荷の問題はあります。例えば実装しているときには例外パターンを考慮できていなかったり命名が適当になっていたり、コードを書かなくても良い解決方法を模索せずについついコードを書いてしまったり。

これ自体はしょうがないことなので、大事なのはチームとしてのレジリエンスを持っていることなのかなぁと思っていたりします。例えばレビュープロセスやデイリーMTGで指摘し合ったり、社内勉強会で共通認識を作ることで、こういった「うっかり」を減らせるし、チームであれば個人の認知負荷の限界を簡単に越えれます。得意不得意をチームで補うという感じ。シニアエンジニアでも抜け漏れはあるものなので、気にせず指摘し合えると良いのかなぁと思っています。

それはそれとして個人としてもこういった抜け漏れは減らしたいですよね。これは認知負荷を減らすのが鍵なのかなと思っています。

たとえば「実装」というタスクがあった場合、この中でも

正常系を書く
正常系のテストコードを書く
例外パターンを書く
例外パターンのテストコードを書く
PRを作る
セルフレビューしてみる
レビュー依頼する

といった感じでやることを分割すると認知負荷を減らせます。セルフレビューも効果的で、IDEでコードを書く脳の使い方を、WebUIなどでコードを読む脳の使い方は結構違って、同じ人が同じコードを読む場合でも違う視点を手に入れることができます。また、１日寝かせることで固定観念を取り除くことができて「そもそもこうじゃなかったっけ…？」「実装しなくても解決できなかったっけ…？」といった視点になれるのでオススメです。

管理画面を作るときに気をつけていること

Mon, 29 Sep 2025 22:40:00 +0900

管理画面を作るときに気をつけていることを雑に書いてみる。

作らない

管理画面に限らずですが「作る」と 初期開発＋保守（不具合修正・機能追加/変更・FWアップグレード・認知負荷） のコストかかります。時間は常に足りないものなので、モノづくりをせずにスマートに解決できる方法があればそれを選択すべきです。

例えば「データを閲覧・分析したい」といった要件であれば管理画面で閲覧するのではなく、Metabase、Redash、Looker StudioなどのBIツールを使うことで作らずに要件を満たすことが出来ます。これらのBIツールは非エンジニアでも扱えることが多いため、作るためのコミュニケーションコストを削減できることもメリットです。また、そもそもの要件や運用を見直すことで解決できる課題も多く、そのためには要件・ビジネスの深い理解と広い引き出しが必要になってきます。

低頻度の要件であれば手順書を残した上であえて手動で対応することも検討すると良いです。例えば年１回の１時間の作業であれば、プログラムを実装・運用するコストよりも安くなるケースもあると思います。ただし手順書が複雑、あるいはセンシティブな操作を含む場合は自動化する範囲を限定して実装するなど柔軟に対応できるとベターです。

SSOな認証を入れる

認証基盤をちゃんと作るには「登録」「ログイン」「パスワード変更」「パスワード忘れ」などの機能を作る必要があります。SSOな認証が入れられるケースだと「登録」「ログイン」のみ実装すればよいので保守性・管理性が良くなります。退職時などユーザを無効化したい場合はSSOのIdP側が無効化されれば、管理画面側もログインできなくなるので運用面においても簡単・安心です。（とはいえ、無効化する処理や運用もセーフティネットとして持っておいたほうが良いと思います）

OIDC連携できるOSSも数多くありますし、Google CloudのIAPのようにインフラレベルで対応しているケースもあるので、比較的工数をかけずに実装ができます。

証跡を残す

管理画面はマスタ管理や個人情報閲覧など重要な操作が含まれることが多いです。データの「変更」だけではなくデータの「閲覧」「ダウンロード」も重要な操作の１つです。

セキュリティインシデントなど何か障害が発生した場合に、アクセスログは重要な証跡で、セキュリティインシデントにおいては「何かをした」ことだけではなく「何もしていない」の根拠になるのは非常に心強いです。そのため管理画面には必ずアクセスログを残しておきましょう。

内容としては最低限以下の情報を含めておくと良いです。

timestamp（いつ）
管理者ID（誰が）
HTTPメソッド（どうした）
エンドポイント（何を）

ただし、個人情報はログに残さないように気をつけてください。

パーマリンクなURL設計

不具合報告、変更依頼などのコミュニケーションにおいて、具体的なURLベースでやりとりできると認識齟齬が減ったり調査がしやすくなります。基本的には参照系のリクエストはGET、更新系のリクエストはPOST(APIではPUT/PATCH/DELETEも含む)にするのを意識してURL設計してもらえれば基本的に問題ないです。

例えば一覧検索が POST https://example.com/search という感じで、参照系の処理をPOSTにするとURLに検索条件が入らないため、URLだけでは どのパラメータを指定してアクセスしたのか の情報が落ちてしまいます。また一覧・検索系の画面ではURLパラメータを残すことで指定の検索条件をブックマークできるメリットもあります。

シンプルで統一されたUI/UXにする

パーマリンクのところと通じるところがありますが、マスタ管理系であれば以下の画面をベースにするとUI/UXが統一されて良いです。

機能	エンドポイント
一覧（検索含む）	`GET /entity`
新規作成画面	`GET /entity/create`
詳細画面	`GET /entity/{id}`
編集画面	`GET /entity/{id}/edit`
新規作成処理	`POST /entity`
更新処理	`PUT /entity/{id}`
削除処理	`DELETE /entity/{id}`

Laravelには resource というルーティング定義やscaffoldがあるのでそちらを利用すると良いです。

要件によっては詳細画面が不要（編集画面で十分）なケースや、新規作成はエンジニアが手動でDB INSERTし、管理画面上は更新のみでOKといったケースもあると思うので、そのあたりはケースバイケースで。

ただ、UIを変えると開発者も利用者も認知負荷や考慮事項も増えがちなので、そのあたりは仕様を慎重に検討していくとよいかと思います。JavaScriptも開発の認知負荷を上げる要因にもなるので必要最小限の利用に留めると良いです。

利用環境を制限する

フロントエンドではブラウザごとの差分があるため、可能であれば利用ブラウザなどを制限できると良いです。例えばChromeの最新版を使う、といった制限を行うことでブラウザ間の互換性を気にしなくても良いのに加え、JSの最新の機能を使えたり、そもそもJSを書かなくてもHTML/CSSだけで対応できるようなケースも増え、工数削減や保守性の向上を見込めます。また、トラブルシューティングの際も同一ブラウザで検証できるため、対応コストが低くなります。

ヘルプ・説明を入れる

複雑な操作・危険な操作はヘルプ・説明を入れておくと安心です。画面上部やツールチップなどでメッセージを表示しても良いですし、 wikiのURLを貼っておけば、ヘルプの更新性が上がるためオススメです。ドキュメントは基本読まれないので、管理画面の機能とリンクさせておくことで読まれやすくして、トラブルが発生したときなどでドキュメントに辿りやすくするという仕掛けにもなっています。

危険な操作には確認を入れる

JSのconfirm()や確認画面を入れておくと比較的安心です。

代理ログイン

権限系のテストを簡単に行えるように、代理ログイン（他のユーザになりすましてログイン）する機能を開発環境に入れたりすることがあります。ロール・属性操作で簡単に検証できることもあるので入れなくても十分なこともある。

お金は物事を動かす

Sun, 28 Sep 2025 22:50:00 +0900

当たり前だけど、ビジネスで物事を動かすのはいつだって「お金」だ。と改めて思ったので駄文を書く。

ビジネスをしている以上は売上＝お金が大事なので、だいたいの施策は「売上を伸ばす」（トップラインを上げる）か「コストカットをする」（人件費や固定費を減らす）の二軸になると思っている。

顧客向けの機能開発は、売上を伸ばすため（営業力強化・チャーン回避）
社内向けの機能開発は、効率化による人件費削減＝コストカットをするため
インフラコストの削減は固定費削減＝コストカット
ツールやサービスの見直しは固定費削減＝コストカット
技術的負債の解消は開発生産性向上により、間接的に売上を伸ばしたり人件費のコストカットをするため

といった感じ。

なのでわかりやすく売上やコストカットに結びつく施策は通りやすく評価もされやすい。既存・潜在顧客からのリクエストが高い機能は優先されるし、固定費が確実に削減されるインフラやサービスの見直しも案件化されやすい。

一方で、R&D、PoC、大規模な技術基盤改善の案件などは、プロジェクト化ができなかったり、途中で打ち切りになるケースもそれなりに見たことがある。これも一種の「お金」が物事を動かしたケースで、直接的な売上貢献・コストカットの効果やその期限が見えづらい、というのが原因ではないかと思っている。

という感じで、何か課題を感じたときに、その課題解決をするためにはどうやればお金と結びつけれるのか、というのを考えるとよいのかもしれない。開発生産性であれば具体的な指標が提示できると良いし、施策開発のついでに技術的負債の解消をするというのも「お金」に結びつけた戦略的なやりかたである。

とはいえ、技術的負債の解消は「お金」と結びつけるにはかなり難しく、計測の前提を揃えることがほとんど不可能なので定量的な効果を伝えづらい。例えば、リプレースの案件ではリプレース以外をやろうとしたり、適切に「作らない選択」をしないと工期が延びて疲弊するため、一般的にはアンチパターンだと思っている。しかしながら「お金」と結びつけるには、リプレース以外の付加価値をエンドユーザにわかりやすい形で提供しないとプロジェクトの効果を伝えづらいため、リプレース以外のことをやるのも戦略としては大事だったりする。

ということで、こういった定量化や可視化、といったことも意識していろんな引き出しを持っておくとより技術力を活かせるのではないのかなぁと思ったり。

レガシーフロントエンドの漸進的改善戦略

Sat, 27 Sep 2025 23:00:00 +0900

jQueryベースのレガシーフロントエンドをモダンにするためのアレコレをまとめます。なお、一足飛びなリプレースの話ではなく地に足ついた一歩ずつの改善です。

不要コードの削除

モダン化のすべての基本ですね！不要なコードを削除していきましょう。バックエンドと違って静的解析で検知することが若干難しいのですが、コードをgrepしたりアクセスログを見て利用していないことを確認すれば比較的安全に削除していくことができます。

なぜ最初にやるかというと、フォーマッタやLinterが全適用になるので無駄な変更になったり認知負荷が上がるためです。

フォーマッタやLinterを入れる

とりあえず何かしらフォーマッタやLinterは入れておきましょう。フォーマッタは一括適用でき、リスクが低めなので早めに入れましょう。Linterはエラーをすべて解消するのは大変なのでignoreしたり設定を無効化したりして導入しましょう。

使うツールとしては設定が簡単でフォーマッタとLinter両方に対応している Biome がオススメ。どのツールを使うかよりは導入すること自体の価値のほうが圧倒的に高いので、何でも良いのでそれなりに枯れているツールを迷わず入れれば良いと思います。

JavaScriptのビルド環境を整える

ビルド環境が整っていないと、お手製のキャッシュバスティングをしていたり（あるいはキャッシュバスティング忘れてうまく変更が反映されなかったり）、HMRが効かなかったり、minifyなど最適化した状態で配信されていなかったり、Nodeモジュールが使えなかったり、TypeScriptが使えなかったりと色々と不便です。適切にモジュール化できれば、グローバル汚染も防げます。ということでビルド環境を整えましょう。

使うツールとしてはとりあえず Vite を入れておけばOK。Laravelなら Laravel Vite Plugin で良い感じにVite連携できます。

ビルド環境を整えずNative ESMを使う方法もありますが、キャッシュバスティングやHMRなどのメリットを考えると、ちょっと頑張ってビルド環境を整えたほうが良いと思います。

Nodeモジュールを使ったバージョン管理

ダウンロードしたjQueryなどのライブラリをそのままGit管理していたりするのはレガシーフロントあるあるですね。ということで、上記でビルド環境を整えたらライブラリをNodeモジュール(NPM)から使うように変更しましょう。これによってGit管理も軽くなるし、Renovate/Dependabotなどの自動アップデートも機能するようになります。

CDNや type="javascript" で読み込んでいるライブラリはwindowのグローバルに定義されているため、最初は以下のようにESM内でグローバルに定義することで既存のコードを変更せずにNPM板を利用することができます。

import $ from 'jquery';

globalThis.$ = $;

エラー管理ツールを導入

レガシーフロントエンドを改善するとき、予期せぬエラーが発生するのは常です。というか改善して無くてもエラーが出てます。気づいてないだけ。特に本番環境ではブラウザやネットワークなど様々な要因でエラーが発生しがちです。ということでエラーを早く検知できるようにSentryなどのエラー管理ツールを導入して、検知・管理ができるようにしましょう。

TypeScriptを使った型付け

フロントエンドはバックエンドと比べるとテストが書きづらい、あるいはテストの効果を出しづらいです。ということでTypeScriptを使って型安全にしておくと堅牢性が上がって良いです。関数化された処理では引数や戻り値を型付けしていくと安心です。とはいえ、jQueryなどの直接的なDOM操作だとTypeScriptの型付けの恩恵が受けづらいです。できれば部分的にAlpine.jsやReactなどの宣言的UIに置き換えてTypeScriptの恩恵を受けれるような形に持っていくのがオススメです。

テスト実装

フロントエンドもテストできる部分は関数化するなどしてテストを書いていきましょう。ツールとしてはVitestがオススメで導入が簡単なのと、Vitest Browser Mode を使えばjQueryのテストも可能です。

ライブラリの定期アップデート

ライブラリがNPM管理されていると、ライブラリの定期アップデートができます。ということでRenovateやDependabotによる定期アップデートを入れましょう。個人的にはRenovateがオススメです。よく使う設定は以下のブログ記事を参照。

よく使う Renovate の設定

リファクタリングする

以下のようなリファクタリングをちょっとずつ行います。

`var` ではなく `let` `const` を使う

varは再宣言や巻き上げ（ホスティング）の問題があり、可読性の低いコードや予期せぬ挙動を生む可能性が高いため利用しない方が良いです。基本的にconstを使い、再代入が必要なものだけletを使うと安全です。

【JavaScript】var / let / const を本気で使い分けてみた

グローバル定義を使わない

<script> の中で定義した変数・関数や、ESMで window.xxx = ...; と書いたものはグローバル（windowオブジェクト）に定義されます。グローバルに定義されると影響範囲がわかりづらくなるので、別ファイルから使う関数は export しておき、利用側で import してください。共通で使いたいモジュールローカルな変数はexportしたsetter/getter経由でアクセスする感じになります。

Laravel Vite PluginのTIPS

Mon, 22 Sep 2025 23:00:00 +0900

LaravelでViteを良い感じに使うプラグイン Laravel Vite Plugin のTIPS的な。

Laravel Vite Plugin で tsconfigPaths がうまく効かないケースがある

tsconfig.jsonのpathsで @/* に ./resources/js/* 以外（例えば ./resources/ts/* とか）を指定した状態で、vite-tsconfig-paths を使っても ./resources/js/* の方にaliasが効いてしまう（エディタ上ではtsconfig.jsonを見て補完や型が効いたりするがビルドで失敗する）。

理由としては vite-tsconfig-paths はモジュールパス解決（resolve）に対して変更するのだが、 laravel-vite-plugin がaliasを自動設定するため @ のresources/jsのエイリアスが先に効いてしまうため。

解消方法としては tsconfig.json と同じ設定を vite.config.js にいれる。

以下のような感じでtsconfig.jsonをパースしてaliasを自動設定することも可能だが、ちょっとtoo muchな感じもする…。

{
 resolve: {
 alias: Object.fromEntries(
 Object.entries(tsconfig.compilerOptions.paths).map(([key, values]) => {
 let value = values[0];
 if (key.endsWith("/*")) {
 key = key.slice(0, -2);
 value = value.slice(0, -2);
 }
 
 const nodeModulesPrefix = "node_modules/";
 if (value.startsWith(nodeModulesPrefix)) {
 value = value.replace(nodeModulesPrefix, "");
 } else {
 value = path.join(__dirname, value);
 }
 
 return [key, value];
 })
 ),
 },
}

HTTPS対応

ローカル開発環境をHTTPSでホスティングしている場合、Viteのサーバーの方もHTTPS対応しないとMixed Contentでうまく動かない。

以下のような感じで秘密鍵や証明書を設定すればOK。

{
 server: {
 https: {
 key: fs.readFileSync('/app/dev-key.pem'),
 cert: fs.readFileSync('/app/dev.pem'),
 },
 },
}

HTTPSでホスティングする場合はホスト名でのアクセスになると思うので、その場合はViteにもホスト名を設定する必要がある。

{
 server: {
 host: true,
 hmr: {
 host: '{domain}'
 },
 cors: { origin: 'https://{domain}:{port}' },
 },
},

「スクラム開発しよう」じゃなくて「チーム開発しよう」でええやん

Sat, 20 Sep 2025 22:40:00 +0900

「スクラム開発しようぜ」みたいなのが何となくあまり好きじゃなくて…スクラムの概念は好きなんだけどイベントを教条的にやるのが嫌い。というか、あのわかりづらいイベント名が嫌いなのかもしれない。

とりあえずチーム開発において以下を重視したいと思っている。

デイリーMTG

日々の進捗や困りごとを雑に共有していきたい。自然発生的な雑談をしても良い。デイリーMTGはコミュニケーションの基盤。開発TIPSとか便利ツールとか気になった記事とか共有しても良い。今、誰が何をやっているのか、なにかバッティングしそうなタスクはないか、フォローできることがないか、そういった個人がやっているタスクをチームのタスクにする意味合いもあるかもしれない。

「スクラム」では「デイリースクラム」って呼ぶらしい。

タスクの棚卸し・進捗確認

差し込みタスクや改善系タスクなど諸々棚卸しして、適切にタスクを割り振っていきたい。棚卸しする過程でチームメンバーは プロダクトの動き みたいなのを知ることができる。

だいたいこのタスクやっていこう、これくらいのスケジュールでちゃんとやっていきましょう、みたいなのが全体的に認識を揃えることが大事。納期を守ることも大事だが、納期があることを意識するのが大事。そうすると、差し込みが発生したときに別のタスクが送れるよね、みたいなのが可視化できて説明しやすい。

「スクラム」では「スプリントプランニング」って言うらしい。

振り返り

めっちゃ大事。個人やチームの成長に影響を与える。

１〜２週間ごとの全体的な振り返り（よかったこと、これからこうしたい、とか）をしていく。これ以上頻度が低いと思い出しづらいし、頻度が高いとネタがなくなりがち。振り返り手法はなんでも良い。振り返り自体を楽しむことが大事。振り返り自体も大事なコミュニケーション手段。

定期的な振り返り以外にもポストモーテムといった障害発生時の振り返りも行う。プロジェクトなどの大きめなタスクもステークホルダーを巻き込んでちゃんと振り返る。エンジニア以外も巻き込むことで新しい視点が手に入る。振り返りをしたらネクストアクションやその期日を設定できるとベターだが、慣れていなければ振り返るだけでもOKだと思っている。

「スクラム」では「レトロスペクティブ」って言うらしい。わかりにくい…。

結局スクラムと同じことやってるじゃん

はい。そうなんだけど専門用語なくて素人でもわかりやすくない…？

変に「スクラム勉強します！」ってならなそうじゃない？ｗ

何がチームに不足しているのか、それを取り入れるだけで良いじゃない。

っていうのと、これくらいのチーム開発におけるイベントは、だいたいどのチームもやっていると思うんですよね。スクラム云々じゃなくて。

ところでスプリントレビューは？

成果物のレビューはステークホルダーと開発者間で当たり前のように実施されるべきなので省きました。普通にステークホルダーのレビューなしでリリースしませんよね…？

で、開発に携わっていない開発者も含めたチーム全体のスプリントレビューでいうと、やった方が良いけど工数の問題やどこまでリソース割く？みたいな話もあるのでデイリーMTGやタスクの棚卸しMTGでちょろっと会話できそうであればそこで軽く共有するとかでも良いのでは？と思っている。

やるとしても「スプリントレビュー」という名前ではなく「成果物のレビューとフィードバックの会」という名前にすると思う。

よく使う Renovate の設定

Sat, 20 Sep 2025 22:00:00 +0900

定期パッケージアップデートで Renovate をよく使っています。柔軟なスケジュール管理やアップデート対象をグルーピングできたりするので便利です。が、設定がちょっと色々できるので、推奨設定や運用方法をまとめておきます。

設定例ベースで紹介していきます。

{
 $schema: "https://docs.renovatebot.com/renovate-schema.json",
 extends: ["config:recommended", "helpers:pinGitHubActionDigests"],
 timezone: "Asia/Tokyo",
 schedule: ["before 9am on Monday"],
 minimumReleaseAge: "3 days",
 rangeStrategy: "pin",
 packageRules: [
 // Python / uv
 {
 matchUpdateTypes: ["minor", "patch"],
 matchDepTypes: ["project.dependencies"],
 groupName: "python dependencies",
 groupSlug: "python-dependencies",
 },
 {
 matchUpdateTypes: ["minor", "patch"],
 matchDepTypes: ["dependency-groups"],
 groupName: "python dev dependencies",
 groupSlug: "python-dev-dependencies",
 },
 
 // Node.js / NPM
 {
 matchManagers: ["npm"],
 matchUpdateTypes: ["patch", "minor"],
 matchDepTypes: ["devDependencies"],
 groupName: "NPM dev dependencies",
 groupSlug: "npm-dev-dependencies",
 },
 // PHP / Composer
 {
 matchManagers: ["composer"],
 matchUpdateTypes: ["patch", "minor"],
 matchDepTypes: ["require"],
 groupName: "Composer dependencies",
 groupSlug: "composer-dependencies",
 },
 {
 matchManagers: ["composer"],
 matchUpdateTypes: ["patch", "minor", "major"],
 matchDepTypes: ["require-dev"],
 groupName: "Composer dev dependencies",
 groupSlug: "composer-dev-dependencies",
 },
 // PHP/MySQLのメジャー・マイナーバージョンのPRは作成しない
 {
 matchPackageNames: ["php", "mysql"],
 matchUpdateTypes: ["major", "minor"],
 enabled: false,
 },
 // LaravelのメジャーバージョンのPRは作成しない
 {
 matchUpdateTypes: ["major"],
 enabled: false,
 matchPackageNames: ["/laravel/framework/"],
 },
 ],
}

json5を使う

設定ファイルとしてjsonではなくjson5 ( renovate.json5 ）を使いましょう。コメントが書けたり色々使い勝手が良いです。一応Renovateの仕様上は .json でもコメントが書けるようなのですが、json5の拡張子にしておいたほうがIDEのサポートも受けられるため明示的に指定したほうが良いです。

他人のサンクコストは捨てづらい

Wed, 17 Sep 2025 23:30:00 +0900

自分は自分自身のサンクコストを捨てれる方だとは思っている。そもそも仕様解釈が間違っていたり、実装方針間違っていたり、あるいはより良い解決策があればそれを選択すべきだと思っている。

しかしながら、サンクコストを捨てれるかどうかは人に依る。大きな方針転換があったときに「せっかくこんなに工数かけて頑張って作ったのに！」みたいな反応する人も少なからず居る。また、たとえサンクコストを捨てれる人であっても気を使うことが多い。

ということで他人のサンクコストは捨てづらい。というか捨ててもらうには仕事の進め方やコミュニケーション戦略が必要になる。個人的には以下を気をつけたほうが良いのかなと思っている。

その人との信頼関係を作る
サンクコストを捨てやすい状況を作る（大きなサンクコストにならないようにする）
サンクコストを捨てなくてもよくする
情報を丁寧に伝える

1 はまぁそりゃそうだよねという話。信頼関係や心理的安全体があればサンクコストは捨てやすくなる。
2 は例えばタスクを細分化して、サンクコスト自体を下げて捨てやすくする。PRならレビューできる粒度で分割するし、コードじゃなくても何をやっているかの進捗共有をこまめにやっていく、とか。
3 も似たような感じで、そもそも手戻りが多くなったりサンクコストが大きくなってくるのは後ろの工程になるので、前の工程、例えば「要求整理」「要件定義」「設計」といった前提のところからちゃんとレビューなり一緒に作業していくことで、認識のズレが少なくなる。
2 や 3 はすでに大きなサンクコストになっている場合は対応できない。その場合、4 で前提となる情報を丁寧に伝えていき、少しずつ誘導していくような形になりそう。

「せっかくこんなに工数かけて頑張って作ったのに！」といった問題が発生するのは一見するとその人のサンクコストの捨てづらさの問題もあるけど、単にコミュニケーションの問題でもあったりする。もっと事前にレビュー入ってたら良かったな、とかもう少し丁寧に情報共有すれば良かったな、とか。

ところで生成AIはそのへんのサンクコストが低いので捨てやすい。この「捨てやすさ」が生成AIの武器なんだろうなぁとは思ったり。

laravel newしたFrankenPHPなアプリケーションをCloud Runでホスティングするまで

Tue, 16 Sep 2025 23:05:00 +0900

FrankenPHPを laravel new して最速で使う方法をメモ

とりあえず laravel new

laravel new frankenphp

フロントエンドは React を選択

ローカル環境のDockerを整備

とりあえずDockerfileやcompose.ymlを作る

FROM dunglas/frankenphp:1-php8.4-bookworm

ENV COMPOSER_ALLOW_SUPERUSER=1
ENV DEBCONF_NOWARNINGS=yes

RUN ln -sf /usr/share/zoneinfo/Asia/Tokyo /etc/localtime

RUN apt-get update \
 && apt-get install -y --no-install-recommends \
 locales strace vim git less unzip

RUN install-php-extensions @composer xdebug

RUN curl -sLS https://deb.nodesource.com/setup_24.x | bash - \
 && apt-get install -y nodejs


RUN sed -i -e 's/# \(ja_JP.UTF-8\)/\1/' /etc/locale.gen \
 && locale-gen \
 && update-locale LANG=ja_JP.UTF-8

ENV LANG=ja_JP.UTF-8

RUN cp /usr/local/etc/php/php.ini-development /usr/local/etc/php/php.ini

必要に応じて pdo_mysql とか intl とかをインストールする。

プロジェクトがうまくいく要因

Sun, 14 Sep 2025 22:40:00 +0900

プロジェクトがうまく行ったな、と思うときどういう要素があるのかなと雑に考えたメモ

ドメイン理解ができている

周辺のドメイン理解を深めたり、ヒアリングや適切なフィードバックを受けることで作るものが全く検討違いにならないようにする。検討しすぎも注意で、デリバリーも大事なので100点を目指さず60〜80点くらいを目指すバランス感覚も大事。

デリバリーを概ね納期通りに完了させる

デリバリーが大幅に遅延してしまうと、そのプロジェクトへの期待感が下がってしまうような感覚がある。メンバーの士気も下がるだろうし、全体的に熱量が下がってしまう感じ。リリースというのは成果物を公開することによる期待値調整の意味もあるので、多少品質が悪くても早めに出すことで「あのプロジェクトの人達何してるの？」感もなくなるし、フィードバックを早く受けれるようになり、改善サイクルをより回すことができる。

リリース後のマーケティングができている

リリースしたあとにその機能やサービスを全員使ってくれるかと言うとそうではない。機能・サービスの啓蒙やユースケース（＝使ってくれた人の成功体験）の共有を根強くやっていかないと使ってくれない。

特にユースケースの共有は机上ではない現実的な成功体験なので利用者もイメージが湧きやすく、体験した人は自己肯定感が上がり、共有された人もワクワク感があるのではないかなと思ったりする。

ということで、技術力というのは実はファクターとしてはそこまで大きくないのではないのかなと思ったりした。いや、もちろん技術が無いとデリバリーできないし、プロジェクトの後の別のデリバリーの速度が落ちたりするわけで大事なんですけど。ドメイン理解とリリース後のマーケティング・セールスもそれ以上に大事ですよね、みたいな。

ORMのselect()は原則使わない方が良いのでは？

Sat, 13 Sep 2025 22:40:00 +0900

と思ってます。

Laravelだとこういうクエリは原則使わないほうが良いのかなぁと。

User::select('id', 'name')->get();

項目が限定されて取得されている、という認知負荷

項目が限定されて取得されているので、select()されていないデータを取得しようとして、DBにデータが入っているのにnullを返してしまったりします。直接的にデータ取得するときもそうですが、getterなど間接的に利用されている場合はさらにわかりづらいです。

また、仕様変更などでselectする項目が増えたときに修正箇所が増えて面倒というのもあります。selectの修正漏れで期待通りに動かず右往左往、ということもありそうです。

静的解析でのチェックも基本的に難しく Laravel/Eloquent で言うと PHPStan/Larastan でselectされていない項目をnull判定するなどの細かい検知はできません。

ちなみに、Node.jsのPrismaはselectした項目を良い感じに型付けしているORMなので静的解析でのチェック・補完ができるのですが、仕様変更時などでselectを逐一追加する運用コストは変わりません。また、こういったselectレベルで型安全なORMはPrismaくらいしかなさそう、というのもあります。

selectしたところでそんなにパフォーマンスは上がらない

だいたいパフォーマンス目的で！みたいなこと言われるんですがそんなにパフォーマンス上がりますか？測りましたか？ところでそれは人件費よりもコスパ良いですか？

もちろんORMはメモリを食いがちですが、それであればORMのモデルクエリよりはクエリビルダでSQLを直接書いたほうが良いかもしれません。

オンボーディングはこうしたら良いんじゃね

Fri, 12 Sep 2025 22:50:00 +0900

自分が今までオンボーディングを受けてきた中で、受け入れ側が「良いオンボーディング」をするために具体的に何をしたら良いんだろうかみたいな駄文を書く。なお、自分は受け入れ側で全然できていない感じがする…ｗ

チームで顔合わせする

初日に顔合わせの時間（自己紹介などの時間）をしっかり取る。大事なのは「顔合わせ」することなのでMeetやZoomでちゃんと顔出しする。顔や話し方を見ないと人となりがわかりづらくてコミュニケーションしづらいんですよね。そういう意味でもできればオフラインが良いと思う。

初日以外でもチームのデイリーMTGや振り返りMTGなどは積極的に参加してもらったほうが良い。アンチパターンとしては「あの人は入社したてなのでMTG入ってもしょうがないので参加しなくて良いよね」みたいなムーブはしないほうが良い。

初日/初月にウェルカム感を出す

ジョインした直後は色々不安になっている。人間関係うまくいくかなぁとかドメイン知識無くて何言っているかわからないとか、総合的にマッチする環境なのかなぁとか。そんな中、入社おめでとう感を出してもらえると新入社員としては安心する。今までの会社だと

ウェルカムバルーン（風船に名前が書いてある）
ウェルカムランチ（チームメンバーや新入社員同士とのランチ。あとはメンターとご飯に行ったり）
1on1リレー

をやっていることが多い。ウェルカムランチは1on1よりもカジュアルに雑談や仕事の相談とかもできるので結構良いなぁと思ってる。バルーン用意するのは面倒かもしれないけどウェルカムランチは予定抑えるだけだからすぐできると思うし。

Good First Issue をやってもらう

前述の通りジョインした直後は貢献していけるのか不安になるので、少しでも早く貢献してもらってチームの一員になったということを実感してもらうのが良い。

内容としては文言変更のレベルで良い。文言で検索して直すだけでよく、影響範囲も少ない、切り戻しもしやすい、UI変更なのでテストしやすい・わかりやすいのがメリット。開発環境が整っていなくても文言変更だけであれば何とかなる。

できれば社員研修を除いた初日にリリースしたい。そのためにもローカル開発環境を整えて簡単に環境立ち上げ・開発できるようにしておきたいし、CI/CD環境を整えて簡単にリリースできるようにしておきたい。Good First Issueを提供するには定常的にタスクを棚卸ししておく必要もある。

ということで総合的に色々とできていないといけないんだが、仮にそういった環境がなかったとしても「早めに初回リリースしてもらう」意識はしておくと良い。基盤が整っていなくてもそういった姿勢が見えるとウェルカム感があって嬉しい。

プロアクティブにコミュニケーションする

タスクをやってもらうとき、なにかあればいつでも質問してください！という姿勢（PULL型）も大事なのだが、どちらかというと定期的にMeet/Zoomなどで時間を取って質問ありますか？どんな感じですか？みたいなPUSH型のコミュニケーションをするとやりやすい。シニアだからPULL型で質問してよ、みたいなのは気持ちはわかるし、まぁそうだよねって思うんだけど、それでも補助いただけると嬉しい。

あとやっぱ大体の人って忙しいので聞きづらいんですよ。どこに何のドキュメントがあるかもわからないし、初月は質問だらけになってメンターのタスクを止めてもらうことになるし。いや、それを理解したうえで質問しまくったほうがよいんだけど、メンター側がどう思っているかという不安はあるわけですよね、人間関係が構築できていないので。

ログ・アラートガイドライン

Fri, 12 Sep 2025 22:00:00 +0900

どの会社でもログやアラートのガイドラインというのを書いているなぁという感じなので、もうここでまとめて参照させたい、という意図で公開してみる。

ログ

ログレベル

基本的には以下の４つで利用することを推奨。

レベル	説明
DEBUG	開発用。デバッグは各種デバッガーでやることが多いのであまり出番はないかも。
INFO	どこまで正常に終了したかを確認したり、アクセスログなど簡易的に追いたい指標として利用。処理が長くなりがちなバッチ処理で利用することが多い。有用ではないログが大量に出る感じでなければ手軽に使ってOK。
WARN	即時対応が必要ではないエラーのログに利用。例えば、単位時間あたりに閾値以上の回数エラーが発生すると異常とみなすようなときなど。
ERROR	即時対応が必要なエラーの場合に証跡を残すために利用。別途SentryやDatadogなどエラー管理ツールに送信するとベター。ログと連動させて自動で送信しても良いが、意図せず通知してしまうことも多いので運用上注意が必要。

MonoLogの場合は他にもNOTICE ALERT CRITICAL EMERGENCY のログレベルがあるが、使い分けが難しく運用しきれない可能性が高いため、まずは上記の４つで運用する。細かく分けないと厳しいケースが出てきたら改めて検討する。

ログの出力内容

[MUST] 個人情報を載せないように注意する
- アクセスログにはクエリパラメータも載るのでURL設計にも注意する（例えば ?name=山田太郎 のようにクエリパラメータに個人情報が載らないようにする）
[MUST] バッチ処理など長めの処理は障害発生時に「どこまで成功したのか」がわかりづらいため、INFOログを適度に残しておく。
[SHOULD] ログ出力のコスト（CPU/IOや転送料金など）が増えたり、本質的なログが見えづらくなることもあるので、Webアプリケーションなどログが増えそうな箇所には不要なログはできるだけ載せない。
[SHOULD] アプリケーションログを出力した場所（クラス、ファイル名、行番号）も入れておくと障害時に追いやすい
[SHOULD] Exceptionのエラーログはスタックトレースも残す
- スタックトレースに引数の値が載らないように設定する。PHPの場合は以下のような感じでiniを設定する。

zend.exception_ignore_args = On
zend.exception_string_param_max_len = 0

[SHOULD] アプリケーションログにはトレースIDを入れておくと１リクエスト単位でまとめてログを確認できるので追いやすいので推奨
- 分散システムの場合は必須。
- DatadogやNewRelicが自動でつけてくれたりする。

ログフォーマット

外部ツール連携性が高いので構造化ログ（JSONL）にする。

Laravelログの例

{
 "message": "some message",
 "context": {},
 "level": 200,
 "level_name": "INFO",
 "channel": "production",
 "datetime": "2024-11-26T16:08:19.585601+09:00",
 "extra": {
 "platform": "laravel",
 "url": "/home",
 "ip": "x.x.x.x",
 "http_method": "GET",
 "server": "example.com",
 "referrer": "https://example.com/referrer",
 "file": "/var/www/html/app/Models/Hoge.php",
 "line": 123,
 "class": "App\\Models\\Hoge",
 "callType": "->",
 "function": "fuga",
 "uid": "8a1d991"
 }
}

属性	説明	必須
message	メッセージ	◯
context	コンテキスト（Laravel）	◯
level	レベル（数字）	◯
level_name	レベル（文字列）	◯
channel	チャンネル	◯
datetime	ログ出力日時	◯
extra.url	リクエストURL	-
extra.ip	IPアドレス	-
extra.http_method	HTTPメソッド	-
extra.referrer	リファラ	-
extra.file	ログ出力したファイル	-
extra.line	ログ出力した行番号	-
extra.class	ログ出力したクラス名	-
extra.function	ログ出力したメソッド名	-
extra.uid	トレースID	◯

ログ出力場所

コンテナ化している場合はCloudWatch Logsに連携する。アプリケーションでは標準出力に出せばOK。

時間不足ではなくスキル不足

Wed, 10 Sep 2025 22:45:00 +0900

自分もそういう発言をすることがあるのだが「時間がなくて」できませんでした、やりませんでした、というのを聞くことがある。「時間がなくて」「施策タスクに追われていて」「スピード重視」で、ローカル開発環境やCIの整備ができていなかったりテストコードを書けていなかったり、コードの品質が悪かったり…などなど。

もちろん本当に時間がないケースもあるが、大抵の場合は純粋なスキル不足のことが多い。

1〜2時間で終わるようなローカル開発環境の整備、CIの整備、ちょっとしたテストコードを年レベルで放置されているのは、おそらくどうローカル開発環境を作ればよいのか、CIを実装すればよいのか、テストコードを書けばよいのかがわかっていない、つまり純粋なスキルや経験が不足している。あるいはこれらが「足りていない」「施策開発に影響を与えている」ことを認識できていないというスキル不足でもある。質とスピードは両立する、ハイスキルな人はある程度の質を担保した上でスピードを出せる、ロースキルな人は時間をかけても質をあげれない、といった話はよく耳にする。

なので、明らかにスキル不足なのに「時間がない」ことを原因とするような主張をされると非常にモヤッてしまう。スキル不足を認めないとその人自身が次のステップに進めないような気もしている。職位・役職関係なく誰しもがスキル不足なのである。それを認めるための振り返りが「ポストモーテム」だったりする。振り返りができる人やチームは、開発環境やCIやテストコードを整備するだろうし、恒久対策のネクストアクションとしてもやりやすいため、結果としてスキルや経験を磨ける、といったことがある。

ということで言い訳したい気持ちはとてもわかるけど、どこかで言い訳せずに向き合って良い感じに前に進めていけると良いな、と自分も含めて思うのだった。

Better PHP Guideline

Tue, 09 Sep 2025 22:10:00 +0900

フォーマッタレベルの話ではないここは抑えてほしいなという感じのPHPのガイドラインというのをどの会社でも毎回書いている気がするので、もうここでまとめて参照させたいな、という意図で公開してみます。

型を書く

PHPは型宣言がサポートされています。適切に型付けしておくと

IDEなどでコード補完が効くようになる
静的解析ツールで型の不整合を事前検知できる
型情報がドキュメンテーションとなり可読性が上がる

といったようなメリットが得られるため、積極的に型を付けていくと良いです。

型付けできるところは以下の箇所になります。

関数・メソッドの引数
関数・メソッドの戻り値
クラス定数
プロパティ

静的解析ツールを使ってより詳細に型検査を行いたい場合はPHPDocによる型記述も有効です。

PHPでは文字列の配列も数字の配列も同じ array で表現されますがPHPDocの場合は

/** @var string[] */
/** @var int[] */
/** @var array<int, string> */
/** @var array<int, int> */

のような型宣言によって区別することができます。

併せてPHPStanなどの静的解析も入れられると完璧です！

# bad
public function someMethod($arg) {}

# good
public function someMethod(string $arg): void {}

strict_types を有効化する

デフォルトでは関数・メソッドの引数の型と実際の値が間違っていても型変換を行おうとします。

function hoge(string $str) { var_dump($str); }

hoge(1); // => string(1) "1"
hoge(false); // => string(0) ""

strict_typesを有効にしておくと、実行時に引数の型が間違っている場合にエラーが発生します。これにより、意図しない引数の型やキャストを防ぐことができます。

declare(strict_types=1);

function hoge(string $str) { var_dump($str); }

hoge(1); // => TypeError hoge(): Argument #1 ($str) must be of type string, int given, called on line 2.

strict types宣言をしたファイル内での呼び出し元のみエラーが発生することに注意してください。
参考: https://qiita.com/Hiraku/items/735f0666ab3d34c52efa

ローカル開発環境を作るときにやっていること

Tue, 09 Sep 2025 21:45:00 +0900

ローカル開発環境を作ることがめちゃくちゃ多くて（というかジョインしたサービスで整備されていないことが多くて…ｗ）自分が作ったり改善していることが多いのだが、何をやっているのか、どういうことに気をつけているのかを書いてみる。

Dockerによるローカル開発環境構築

開発環境構築ツールは色々あれど、現状ではDockerコンテナでアプリケーションを動かすのが無難な感じはしている。

docker-compose.ymlを作っておきApp/DBサーバーを立ち上げれるようにしておく。 AWSやメールなどはモックサーバー( localstack や Mailpit )を入れておく。

開発環境のDockerfileには各言語のランタイム以外には

vim
git
curl
procps
less

あたりは入れるようにしている。日本語化やタイムゾーン設定も忘れずに。

Makeタスクの整理

賛否両論あるが、Makeコマンド・タスクは便利だと思っていて、Makefileは必ず用意している。

個人的にMakeが良いと思っているのは

言語に依存しないのでコンテキストスイッチがかからない
構文が簡単で必要十分な機能を備えている
- タスクの依存関係を簡単に記述できる
- 複数コマンド実行を改行区切りで記述できて読みやすい
- 分岐や変数が使える
- 並列実行
動くREADMEでコメントも自由に書ける

あたり。

だいたいこんな感じなものを作っている。

.PHONY: help
help: ## ヘルプ
	@awk 'BEGIN {FS = ":.*?## "} /^[a-zA-Z0-9_\/-]+:.*?## / {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)

.PHONY: up
up: ## Dockerコンテナの立ち上げ
	docker compose up -d

.PHONY: init
init: ## 初期化
	# ...

.PHONY: install
install: ## ライブラリのインストール
	docker compose exec web composer install
	docker compose exec web npm install

.PHONY: test
test: ## テスト実行
	docker compose exec web ./vendor/bin/phpunit

.PHONY: lint
lint: ## lint実行
	docker compose exec web ./vendor/bin/pint --test

.PHONY: lint
lint/fix: ## lintのautofix
	docker compose exec web ./vendor/bin/pint

.PHONY: console
console: ## Webのコンテナに入る
	docker compose exec -it web /bin/bash
	
.PHONY: db/console
db/console: ## DBのMySQLのコンソールに入る
	docker compose exec -it db /bin/bash -c 'mysql -h {host} -u{user} -p{password} {database}'

.PHONY: logs/web
logs/web: ## Webコンテナのログを表示
	docker compose logs -f web

初期構築は make init だけで済ませれるようにしておくとよいのだが、必要なツールやファイルのダウンロードなどが必要になったりするので、あまりワンコマンドにこだわらないようにしている。

Laravelアプリケーションにはこれを入れておこう 2025

Sun, 07 Sep 2025 22:35:00 +0900

ということで書いていく。

バックエンド

PHPStan / Larastan

Laravel、というよりPHPアプリケーションに対して必須といっても良いくらい大事。

テストを書かない人はまだまだ大半を占めていると感じていたり、カバレッジが充足していないアプリケーションがほとんどだと思うので、テストを書かなくてもある程度堅牢にしてくれるのはレガシー改善職人としては嬉しいところ。

また、Laravelはマジックメソッドが多いためLarastanは必須。Eloquentモデルのプロパティやファサードなどを良い感じに型推論してくれるのはめちゃくちゃ便利。もちろん限界はあるのである程度は割り切って使うのが吉。

構造化ログ

ローカル開発環境はプレーンテキストなログでOKだけど、本番環境・ステージング環境などコンテナサービス上で動いているアプリケーションの場合はJSON形式の構造化ログを出力しておくと良い。こんな感じでログ出力ができる。

class LoggerCustomSetting
{
 public function __invoke(Logger $logger): void
 {
 $introspectionProcessor = new IntrospectionProcessor(Level::Debug, ['Illuminate\\']);
 $webProcessor = new WebProcessor();

 // リクエストごとのユニークIDをコンテキストに付与
 $logger->pushProcessor(new UidProcessor());
 // ファイル名・クラス名・関数名・行番号などをコンテキストに付与
 $logger->pushProcessor($introspectionProcessor);
 // Webリクエスト情報をコンテキストに付与
 $logger->pushProcessor($webProcessor);

 foreach ($logger->getHandlers() as $handler) {
 if ($handler instanceof StreamHandler) {
 $handler->setFormatter(new JsonFormatter());
 }
 }
 }
}

config/logging.phpはこんな感じで上記クラスをtapに設定すればOK

 'stdout' => [
 'driver' => 'monolog',
 'level' => env('LOG_LEVEL', 'debug'),
 'handler' => StreamHandler::class,
 'tap' => [LoggerCustomSetting::class],
 'with' => [
 'stream' => 'php://stdout',
 ],
 ],

Model::shouldBeStrict()

遅延ロードを防ぐための設定。これによりN+1クエリがある程度防げる。また、意図しない属性アクセスなども防ぐことができるのでタイポ防止効果もある。エラーになってしまうため、開発環境のみに入れておいて気付けるような仕組みにしておくと良い。

以下のような感じな設定にすると、本番環境以外でもignore_strictをURLパラメータに入れておくとエラーをスルーして実行できるので必要に応じて入れておくと便利。

Model::shouldBeStrict(
 !$this->app->isProduction() &&
 $this->app['request'] &&
 !$this->app['request']->has('ignore_strict')
);

Laravel Debugbar

開発用にデバッグを簡単にできるツールを入れておくと何かと便利。 Laravel Debugbarは画面下部にデバッグコンソールが表示され、そこでログやクエリ発行、セッション・リクエスト情報を見ることができるので、デバッグ時のvar_dump代わりにもなる。

インストール方法

$ composer require barryvdh/laravel-debugbar --dev

Laravel Pint

フォーマッターは色々あるが、とりあえずLaravel PintというPHP CS FixerをラッピングしたLaravel公式のフォーマッタがあるのでこれを使っておけばOK。気に食わないところはpint.jsonでカスタマイズしつつ。

コンテキストによって「工数」の解釈が変わることに注意しないといけない

Sat, 06 Sep 2025 22:55:00 +0900

工数 という言葉でやりとりするときに人によって解釈が変わっていて納期や見積もりに齟齬が生じることがある。

工数と工期

工数 は「その人がフルアサインされている状態でどの程度時間がかかるか」を示しており、1人日のタスクを1人で行う場合、差し込みがなければ1日で終わるし、その工数のタスクを2つ並行してタスクをやれば2日かかる。

一方で 工期 はそのタスクが完了するまでの期間を指しており、1人日のタスクを1人で行う場合は1日、差し込みがあればもっと時間がかかるだろう。

何が問題になるのか

「工数はどれくらいですか？」と聞かれる場合、 工数 ではなく 工期 を指していることがあることに注意しなければならない。

プロジェクトのディレクションやマネージメントをする人が、タスクに対する 工期 そのものを聞きたいのか、 工数 に対してバッファを載せたり人員を適切にアサインしてディレクション側で 工期 を算出したいのか、を配慮する必要がある。

工数 を聞きたいのに 工期 を出してしまうとバッファが２重で乗ってしまったりして納期や見積もりの精度が大きく狂うし、 工期 に対して 工数 を出してしまうと差し込みなど別タスクに取られる時間もあり納期に間に合わない、といったことが発生する。

どうすればよいのか

工数 と 工期 の違いに対してチームメンバーで再認識しつつ、各コンテキストにおいて何をヒアリングしたいのか、というのを確認しながら進めていくのが良さそう。

納期を大事にする人は 工期 を答えがちで、タスクの精緻な見積もりをしたい人は 工数 を答えがち。何が良い悪いではなくコンテキストや関心事が違うだけなので、お互いいい感じにコミュニケーションして認識をすり合わせていけると良いのかなぁとか。

ロガーインターフェースについて思いを馳せる

Wed, 03 Sep 2025 22:55:00 +0900

pinoのロガーインターフェースを変更するという記事を書いたが、そもそもロガーインターフェースって各言語 / FWどんな感じになってたっけ？というのを気になって調べたのでメモ。

自分が馴染みのある PHP Ruby Go Python Node.js が比較対象。

(string), (string, object) パターン

PHP / MonoLog

$log = new Logger('name');
$log->info('message');
$log->info('message', ['number' => 3]);

Python / logging

# extraを表示するにはformatterを調整する必要あり
logger.info('message', extra={'number': 3})

Go / slog

slog.Info("message")
slog.Info("message", slog.Int("number", 3))

(string) のみパターン

Ruby / Logger

logger.info('message')

ちなみにActiveSupportのTaggedLoggingを使うとタグ（コンテキスト）を付与したロガーを生成できる

logger = logger.tagged('context');

その他

(string), (object), (object, string) パターン

Node.js / pino

logger.info('string message');
logger.info({ message: 'json message' });
logger.info({ message: 'json message' }, 'string message');

(string, object), (object) パターン

winston

logger.info('string message');
logger.info('string message', { message: 'json' });
logger.info({ message: 'json' });

個人的に好んでいるロガーインターフェース

好みの問題かもしれないが (string, object) をサポートしていると嬉しいなと思っている。

SWR の revalidateOnFocus は window.confirm() でも再検証が動く

Wed, 03 Sep 2025 22:00:00 +0900

SWR の revalidateOnFocus オプションが効いた状態で window.confirm() によるダイアログでOK/キャンセルを選択した際にもフォーカスが戻ったとみなされて再検証が動くらしい、というメモ。

再現コードはこんな感じ。confirmを閉じるタイミングで毎回refreshされる。

import useSWR from "swr";

function App() {
 const { data } = useSWR("/hello", async () => {
 return Math.random();
 }, {
 revalidateOnFocus: true,
 });

 return (
 <div>
 <span>{data}</span>
 <button onClick={() => window.confirm("OK?")}>confirm</button>
 </div>
 )
}

export default App

連続してconfirmを押すとrefreshされないことがあるが、多分連続して押したときにブラウザがフォーカスイベントを発生させないのかもしれない。5秒間隔くらいで押すと毎回refreshされる感じ。

なので、window.confirm()しつつその後データ更新を行い、更新後のデータを取得するという場合にはmutate()を使わなくてもリフレッシュされちゃったりする。（とはいえ mutate() を明示的に呼び出したほうが良いんだけど）

pinoのロギングを (string, object) のインターフェースで呼び出したい

Tue, 02 Sep 2025 22:40:00 +0900

Node.jsのロガーライブラリの pino は以下のようなインターフェースでログ出力できる。

const pino = require('pino');
const logger = pino();

logger.info('string message');
logger.info({ message: 'json message' });
logger.info({ message: 'json message' }, 'string message');

見てもらえるとわかるように

第１引数が文字列のみ
第１引数がオブジェクトのみ
第１引数がオブジェクトで第２引数が文字列

に対応しているが、 第１引数が文字列で第２引数がオブジェクト（メタデータ・コンテキスト） には対応していない。

他の言語のロガーはだいたいこの方式に対応していたりするので、pinoもこのインターフェースに対応したい。ということで以下のような感じでカスタマイズできる。

import pino from "pino";

const logger = pino({
 hooks: {
 logMethod(inputArgs, method) {
 // 第１引数が文字列, 第２引数がオブジェクトの場合
 if (
 inputArgs.length === 2 &&
 typeof inputArgs[0] === "string" &&
 typeof inputArgs[1] === "object"
 ) {
 const msg = inputArgs[0];
 const context = inputArgs[1];
 // @ts-expect-error
 return method.apply(this, [{ ...context, msg }]);
 }
 // @ts-expect-error
 return method.apply(this, inputArgs);
 },
 },
});

これで

logger.info("string message", { userId: 123 });

という感じで呼び出すと

{"level":30,"time":1756819989743,"pid":27639,"hostname":"xxxx","userId":123,"msg":"string message"}

という感じな出力になる。

vitest-browser-html というライブラリを書いた

Mon, 01 Sep 2025 22:20:00 +0900

Vitest Browser モードはブラウザ上でテストを実行できるモードで、JSDOMを使わずにブラウザのAPIを使ってちゃんとテストできるのが便利。

しかしながら、対応しているライブラリが React や Vue などモダンなものばっかりで、jQueryやAlpine.jsなどには対応していなかった。ということで vitest-browser-html というライブラリを作って公開してみた。

使い方

npm install -D vitest-browser-html

でインストールして、以下のようにして利用する。

import { render } from 'vitest-browser-html'
import { page } from '@vitest/browser/context'
import { expect, it } from 'vitest'

it('render String', async () => {
 const screen = await render('<div>String</div>');
 await expect.element(screen.getByText('String')).toBeVisible();
});

render関数の中にHTML文字列を入れてもらえればOK。

Alpine.jsでテストしたい場合は Alpine.initTree() をcontainerに適用すればOK。

import { render } from 'vitest-browser-html';
import { it, expect } from 'vitest';
import Alpine from 'alpinejs';

it('render by Alpine', async () => {
 const screen = await render(
 '<div x-data="{ foo: `bar` }" x-text="foo">Hello World</div>',
 );
 Alpine.initTree(screen.container);
 await expect.element(screen.getByText("bar")).toBeVisible();
});

jQueryの場合はこんな感じでテストできるようになる。

import { render } from 'vitest-browser-html';
import { it, expect } from 'vitest';
import $ from 'jquery';

it('render by jQuery', async () => {
 const screen = await render(
 '<div id="some-id" data-testid="some-id">hoge</div>',
 );
 $('#some-id').text('fuga');
 await expect.element(screen.getByTestId("some-id")).toHaveTextContent("fuga");
});

これでjQueryを使っているDOM操作系の関数やAlpine.jsのコンポーネントのテストができるようになる…！

Laravelでちょっとした非同期処理をしたい場合は defer() を使うと良いかもよ

Sun, 31 Aug 2025 23:00:00 +0900

Laravelで非同期処理を行いたいときの選択肢はキューワーカーかプロセスの非同期実行になりがちで、キューワーカーは正攻法ではあるがインフラやアプリケーションコードが大掛かりになるし、プロセスの非同期実行はそれ用のスクリプトを書く必要があり、ちょっとした非同期処理を行いたいときには少し面倒だったりする。

ということで調べたら defer() というヘルパー関数があって、プロダクションで使ってみたらめっちゃ便利に使えたのでメモ

defer() とは？

defer() は Laravel 11.23 から利用できるヘルパー関数で、HTTPレスポンスをクライアントに返した後に任意の処理を実行できる。

具体的には以下のような形で呼び出して、擬似的な非同期処理を実行できる。

defer(function() {
 // なんか重い処理
});

return response()->json($data);

擬似的な と表現したのは、別プロセス/スレッドで行うような非同期処理ではなく、HTTPレスポンスを送信したあとに同一プロセス/スレッド内で実行するため。

どう動いているのか

deferで呼ばれた関数は Illuminate\Support\Defer\DeferredCallback でラップされたあとに、 Illuminate\Support\Defer\DeferredCallbackCollection にarray pushされる。

https://github.com/laravel/framework/blob/66d16cb899e007dc8f5f8db33445cfbc9b69a20c/src/Illuminate/Support/functions.php#L18-L29

Illuminate\Foundation\Http\Middleware\InvokeDeferredCallbacks のミドルウェアの terminate() では DeferredCallbackCollection の invokeWhen の処理を呼び出す。 https://github.com/laravel/framework/blob/66d16cb899e007dc8f5f8db33445cfbc9b69a20c/src/Illuminate/Foundation/Http/Middleware/InvokeDeferredCallbacks.php#L25-L37

ミドルウェアの terminate() はレスポンスを送信したあとに動くので、擬似的な非同期処理を実現できるという感じ。

HTTPレスポンス送信後に接続が切れて処理が中断されないのか？

という疑問があったので調べてみました。結論、送信後は接続が切れても処理は中断されないみたい。

mod_php

flush() したあとにクライアントから接続が切られても後続の処理は実行されていそう。

https://github.com/php/php-src/blob/ca4a841921b2c51fc9aa0c1847f0cdd801844ef5/sapi/apache2handler/sapi_apache2.c#L287-L311

クライアントから接続が flush() 前に切られていたら後続処理も実行されないが、そもそもレスポンスも返さないのでまぁしょうがない。

プロダクションのmod_phpな環境で数秒程度かかる処理にdefer()を使っているが問題なく動いている。web記事だとfastcgiでしか使えない？みたいなことが書かれてあったりするけどmod_phpでも普通に動いてます。

fastcgi

fastcgiの場合は fastcgi_finish_request() が呼ばれるが、ドキュメントによるとクライアントにflushしつつ、後続処理を実行できるらしい。

注意

同一プロセス/スレッドで動く制約上、長時間かかるような処理だとプロセス/スレッドを占有し続けてしまうため、バッチやキューワーカーで対応するのが良い。それ以前にロードバランサやWebサーバーのTimeoutに引っかかりそうだけど…。

同様の理由で数秒程度であってもリクエスト数が多い場合でも同じく占有する可能性があるので別の方法を検討したほうが良さそう。ただし、プロセス/スレッド数/インスタンス数を増やすという手もあるのでケースバイケース。

参考URL

https://www.amitmerchant.com/the-magic-behind-laravels-new-defer-helper/

DockerでPHP環境を構築するには install-php-extensions を使うと良いかもよ

Sat, 30 Aug 2025 23:00:00 +0900

Frankenphpのドキュメントを見ていたら install-php-extensions という docker-php-ext-install みたいなコマンドでPHP拡張をインストールしていたので気になったので調べてみたメモ。

docker-php-ext-install

公式のPHPのDockerイメージに入っている docker-php-ext-install はPHP拡張をインストールしてくれるのだが、そのPHP拡張をインストールするために必要な依存関係をaptやapkで自動インストールしてくれないので、その依存パッケージを調べて自前でインストールする必要がある。そして、これがとても面倒で、毎回ググっていたりする。また、peclでインストールする必要がある拡張もあるため、ext-installだっけ？peclだっけ？みたいな脳内分岐ロジックが発生していた。結果としてDockerfileのRUNの中身が増えがちだった。

install-php-extensions

docker-php-ext-installの課題を解決してくれるのが install-php-extensions で、依存関係も含めてapt/apk installしてくれたり、pecl経由のインストールもすべてこのスクリプトが担ってくれている。

例えば zip をインストールするには libzip が必要になったりするがその依存関係を意識することなく以下のコマンドだけでインストールできる。

install-php-extensions zip

さらにはcomposerもインストールできる。マルチステージビルドでcomposer取ってきたりしなくても良い。

install-php-extensions @composer

ということでめっちゃ便利だしFrankenphpのDockerfileでも使われていて品質的にも問題なさそうに思うので、積極的に使ったほうが良いかもなーと思ったりしている。

コードレビューの真の価値はコミュニケーション

Thu, 28 Aug 2025 23:00:00 +0900

コードレビューは概ね以下のような目的で行われている。

コード自体の品質を担保する
- 外部品質 = ちゃんと動くのか。UI/UX的に問題ないのか。
- 内部品質 = 保守性（可読性・拡張性）・セキュリティ・パフォーマンス・自動テスト
コードをチームに共有する（＝チームの所有物にすること）
ドメイン（ビジネス・技術）の共有
コードを通じたコミュニケーション

1の品質担保が一番重要そうなのだが、実際はそれ以外が大事だよ、という駄文を書く。

コードをチームに共有する

コードレビューによって書いたコードがチームの持ち物になる。

何か不具合が発生したときも、そのコードを理解している人が1人でも増えれば不具合解消までの時間は減るかもしれない。解消までの時間が減らなくても不具合発生時の実装者の心理的負担は少なくなる。そのコードに関する機能追加をしたいときもコードがチームの持ち物になれば他の人が対応しやすくなり、チーム全体の生産性が上がる。

コードレビューでは「誰か１人レビュー通ればOK」とか「チームリーダーがレビューする」という運用をしているところがあると思うが、コードの共有という意味ではできるだけ多くの人がレビューしたほうが価値があるし、時間があるときに軽く目を通しておくと良かったりする。

ドメイン（ビジネス・技術）の共有

コードレビューはドメインを共有する機会にもなる。

このテーブルはレコード数が多い、エンドポイントのリクエスト数が多い、同じような処理がありドメインとしても共通化できそう、とか。要求や要件のレビューを通じてビジネスドメインを知る機会になるかもしれない。

エンジニアが技術的な知見を共有し合うチャンネルとしても有効だ。影響範囲を出すための方法、データベース設計やパフォーマンスチューニングの知見、セキュリティを考慮した実装など。コードを実装しなくても解決できるような技術的引き出しを共有することで、より本質的な課題解決ができるようになるかもしれない。

コードを通じたコミュニケーション

コミュニケーションは質より量を意識したほうが良い。エンジニアにとってコードレビューはそれ自体が貴重なコミュニケーションチャンネルの１つだ。

ドメインや知見を共有しなくても「この実装良いですね！」とか「対応ありがとうございます！」とか絵文字のリアクションをつけたりするだけで、お互いに仕事がしやすくなる。

「一旦この実装でOKで、チームで改めて方針は再検討しても良いですね！」みたいな課題発見や問題提起をしても良い。エンジニアはコードがあるからこそ会話しやすい側面もあるので、コードレビューというコミュニケーションチャンネルを活かさないのはとてももったいなく感じる。

生成AIによる自動レビューでは負担は減るけど工数は減らない。

生成AIによる自動レビューは主に品質問題を解消する効果がある。一方で、品質問題を解消しているからといって人間によるレビューが不要になる、ということは全くない。前述の通り、人間がコードレビューをしないとコードがチームに共有されず、知見を共有する機会が減ってしまう。勉強会などで知見を共有する方法はあるかもしれないが、実務ベース・実コードに勝る教材はない。

生成AIのよる自動レビューによって、品質観点のレビューに対する人間の負担は少しは減るのだろうが、共有やコミュニケーションといった部分に関しては無視できない工数がかかるし、無視してはいけない。

レビューで品質を担保することは難しい

品質は「内部品質」「外部品質」に分類される。

「外部品質」の観点だと、開発物が正常に動くのかを見ることになるが、何が正常かどうかは実装した本人とステークホルダーが詳しいはずで、レビュワーは責任を持つべきではない。レビューで細かいところは見切れないし、相当のスキルが求められるため品質担保を目的とするのは現実的ではないというのもある。また、実装者本人が責任を持つからこそ、自動テストや手動テストに対する意識が高まるという効果もある。実際に障害が発生して振り返りをするプロセスを踏むからこそ品質を強く意識するようになる。

「内部品質」の観点だと、事業や組織体制、プロダクトの特性とメンバーの経験や能力によって良い品質の定義が変わってしまう。半端な知識で良い品質を求めた結果、オーバースペックになったりすることはよくあるし、すぐ捨てるコードであれば高い可読性は不要になる。そのため、コードレビューによって品質をある程度担保、くらいはできるが高い水準で担保することは現実的には不可能かもしれない。

コードレビューはコミュニケーションである

端的に言ってしまうとコードレビューは単なるコミュニケーションなので、生成AIで完全代替はできないし、工数はこれからも下がらないだろう。もし下がったのであれば単純にコミュニケーションが足りていないだけである。

コミュニケーションだからこそ、新規参画者やスキルセットが十分ではないメンバーほどコードレビューに参加したほうがチームとして役に立つ。その前提を踏まえた上で、現実的な工数感とかも考慮してレビュープロセスの運用を考えていくとよいのではないかなと思ったり。

チームの能力はそのチームが経験することに依存するのでそう簡単に伸ばせない

Sun, 17 Aug 2025 21:10:00 +0900

チームの能力はそのチームが経験することに依存するのでそう簡単に伸ばせない、という駄文を書いてみる。

例えば、テストを書いていないチームにシニアエンジニアがジョインして諸々を整備したり啓蒙したとしても、チームがテストの有用性について経験していないためテスト文化が浸透しづらくテストカバレッジが思ったより上がらない、ということがよくある。

一方でテストコードで防げたはずの手戻りやインシデント、ミドルウェアやライブラリのアップグレード時の苦難をチームが経験するとテストを推進しやすくなる。ビジネスインパクトの面でステークホルダーへの説明もしやすい。

書籍や登壇資料、Web記事を読んでインプットすることは非常に有用だと思う一方で、それよりは経験から学ぶことが大きいし今後のその人の考え方やキャリアに強く影響する。パフォーマンスやセキュリティ、保守性の問題を経験したエンジニアはその問題に対して強い感度や考えを持つ、という感じ。また、個々人が今まで行ってきた経験よりも、そのチームでの歴史的な経験がチームの考え方に強く影響を及ぼしている。そのため、どんなにシニアエンジニアの経験値や実力が凄かったとしてもチームの能力は、そのチームが経験することに依存する。

チームが学習するためには、ただ単純に「経験」するだけではなく「経験」の後の「振り返り」とその次の「アクション」が重要だったりする。どんなに手戻りやインシデントを経験してもそもそも振り返りをしていなかったり、振り返りに対応するネクストアクションが未熟だと何も変わらない。

例えばテストコードで防げる不具合に対する対策として手動テストの項目をむやみに増やしたり（もちろん手動テストも大事なんだけど）、オペレーションミスに対してシステムや運用フローによって認知負荷を下げるような仕組みを考えずにひたすらにダブルチェック・トリプルチェックとやってしまうと（もちろんレビュープロセスも大事だけど）やはり学習機会にはつながりづらい。

シニアエンジニアの振る舞い

シニアエンジニアが環境を整備したり啓蒙することはもちろん大事なのだが、一番大事なのは失敗しやすい土壌を整え、振り返りを促進し、アクションを提案し、チームとして強くなるきっかけを作ってあげることなのではないかと思ったりする。

小さく早く失敗し、振り返り、学習することがチームにとって重要なので、それを整えてあげたり率先してその姿勢を見せるのもシニアとしての振る舞いとしてよいのかもしれない。

余談

チームの状態に依るのだが、コードレビューに関しては個人的な意見はもちろん述べつつも大きな問題がなければ通すことがある。その設計でうまくいけば良いし、もしうまくいかなかったらそれがチームの経験になり、それを振り返り、改善することで学習につなげることができるからだ。意見を矯正しすぎてしまうのは個々人やチームの成長機会を奪ってしまうような気がしている。IMOなので参考にしてね、くらい。もちろんリスクが大きいもの、切り戻しがしづらいものに関してはしっかりとレビューをしている。

LaravelとReactを使いたいならInertia.jsを使ったほうが良いんじゃね

Mon, 11 Aug 2025 23:10:00 +0900

バックエンドにLaravel、フロントエンドにReactを使いたい場合、ルーティングライブラリにNext.jsを採用し、LaravelはAPIサーバーとして利用するケースが多く見られる。

が、個人的にはこの構成は学習コストや保守性の観点であまりおすすめしておらず、 Inertia.jsを使ったほうが良いのではと思っている。ルーティングがLaravelだけで管理されるだけでなく、APIを意識しないシームレスなデータ連携ができるし、Next.jsほど複雑な仕組みではないので学習コストも低い。OpenAPIやRPC系ツールが目指したようなバックエンド・フロントエンド間の型安全性も Laravel Data や TypeScript Transformer を使うことで解決できる。

ということで、今回はこのあたりの技術について紹介する。

Inertia.js

Bladeは「型安全じゃない」「UIライブラリのエコシステムが弱い」「小さなコンポーネントには向かない」などの理由で色々辛くなりがち。ビューへの変数の受け渡しは実行時にしか検証できないため、不要な変数の検知やリファクタリングが難しく、補完も効かせづらい。

フロントエンドのロジック実装に関しては Alpine.js を使うと保守性が上がるものの、Bladeでコンポーネント指向に書くには少しハードルを感じるし、Alpine.jsはコンポーネント化にあまり向いていない印象。Web Components を使ったとしてもSSRの仕組みが別途必要になったりエコシステムがあまり強くない。

Inertia.js を使うとテンプレートエンジンのように React や Vue を利用でき、「型安全であり」「UIライブラリのエコシステムが強く」「小さなコンポーネント」を作れる。SSRも対応しているのでSEO系も問題なし。画面遷移もSPAな感じでいける。ReactやVueでフロントエンドを実装できるのは開発生産性だけではなく、エンジニアの技術的キャリア形成としても良さそうだし採用面でも期待できる。

Inertia.jsは以下のブログ記事にまとめていたりするので詳細はそちらで。
https://tech.yappli.io/entry/inertiajs

TypeScript Transformer

Inertia.jsを使うと「型安全になる」と言ったが、バックエンドとフロントエンドの境界（propsの受け渡し）はInertia.jsだけでは型安全にならない。そこで、TypeScript Transformerというツールを使うとPHPクラスをTypeScriptの型定義に変換できるため、Inertia.jsのprops受け渡しも型安全にできる。

具体的には Inertia.render() するときにPHPのクラスを引数に指定し、そのPHPクラスの型定義をフロントエンドのpropsで利用すれば良い。Viteのカスタムプラグインでファイル監視しつつ自動的に型定義を生成する、といったことも簡単。

コントローラ例

Route::get('demo', function () {
 return Inertia::render('demo', new DemoData('hoge', true));
})->name('demo');

ページコンポーネント例

// App.Data.DemoData の型がPHPのコードから自動生成される
export default function Demo(props: App.Data.DemoData) {
 // ...
}

Viteのカスタムプラグイン例

Laravel Data

FormRequestは「テストがしづらい」「補完が効かない」「型安全じゃない」といった課題があり、ApiResourceも同様の問題を抱えている。

Laravel Dataを使うとマジックメソッドを使っていないので「補完が効く」し「型安全」になる。また、インスタンス化も簡単でバリデーションもでき「テストもしやすい」。マジックメソッドを使わないので前述のTypeScript Transformerとの相性も良い。

その他

Inertia.jsで利用できるフロントエンドライブラリは React Vue Svelte になる。UIライブラリの充実性と生成AIとの相性を考えてReactを選択するとよいのではないかと思っている。

実装するWebサイトがリッチなフロントエンドを必要としない場合でも

単純なページ表示であればpropsを受け取ってレンダリングするだけ
- stateやeffect管理は不要で、Reactの学習コストが気にならない
ちょっとした表示コンポーネントの共通化も気軽にできる
それでいて型安全、補完が効くので開発体験が良く、負債になりづらい

といった理由で採用する価値があると思っている。

以前はAlpine.jsを推していたのだがコンポーネント性の弱さや、ビュー全体の型安全性も担保できないので、今はInertia.js推しになっている感じ。

とはいえ越えられない壁はある

RSCやReact Router v7、RPC系のライブラリはフロントエンドとバックエンドがTypeScriptということもあり、データの受け渡しなど非常にシームレスな開発ができる。

この点はInertia.jsもそうだが、バックエンドで他の言語を使っている以上はこの開発体験を越えることはできない。また、TypeScriptほどの型表現を持っているバックエンドの言語は限られるため、そのあたりのインピーダンスミスマッチみたいなのもありそう。

とはいえ、バックエンドのエコシステムや開発生産性といったところで別言語のメリットが強い部分もあるため、このあたりはトレードオフとも言えそう。

正論モンスターはなぜダメなのか

Sat, 02 Aug 2025 23:10:00 +0900

私はいわゆる「正論モンスター」がとても苦手なのだが（そして苦手な人が大多数だと思うのだが）なぜダメなのか、どうするべきなのか駄文を書く。

理由1: 正論を言うだけでは何も変わらない

正論をストレートに言えば、周りに思いが伝わって勝手に状況が改善されるのかというと全くそんなことはない。むしろ「そんなことはわかっているけどできないんだよ」といった感じで反感を買ってしまったり、それによって協力を得られづらい状況になることがほとんどだろう。

そもそも組織や文化によっては、その正論が本当に正しいのかすら怪しい。仮に正しかったとしても、その理想状態を作っていくためには「自分で手をちゃんと動かして少しずつ改善する」とか「人を巻き込んで仕組みを変えていく」ことが大事なのかなと思っている。

正論だけではなく次のアクションや巻き込みに対する言葉が無いと何も変わらない。

理由2: 正論を言うだけではリスペクトに欠ける

「正論モンスター」と「正論を言うけどちゃんと物事を動かしてくれる人」の大きな違いの１つに周りへの配慮・リスペクトが見えるかどうかというのがある。

今そこでパッションを持って働いている人がいることに対して配慮が足りていないのはあまり好きではない。楽しく働けて、それでいて厳しさもあり成長し合える環境が望ましいのに、リスペクトが欠けてしまうと居心地は良くないだろう。実情はどうであれ、正論を投げ捨てるだけの人は単純に自分の憂さ晴らしをしたいだけのように思えてしまう。

また、歴史的経緯や組織的状況など様々な要因があるはずなのに、それに対する配慮が欠けていると残念な気持ちになってしまう。チームにジョインした直後など、心理的安全とはいえハレーションが起きやすい状況においては、リスペクトを感じさせる言動や態度が大事だと思う。

ではどうすればよいのか？

自分が新しいチームに入って、ペインや改善点を見つけたとき

「テストや静的解析が無いと不安なので導入しちゃって良いですか！？誰か着手中じゃなければ！」
「◯◯の振り返りしませんか？自分ファシリやるんで！」

みたいな感じで 提案 をしつつ 責任 を自分に向けるようにしている。慣れてきたら 責任 をチームで分担する形にするが、ずっと自分でやっても良いなという心持ちではいる。

これを例えば「テストや静的解析が無くてレガシーですね」とか「振り返りやらないとかダメじゃないですか？」という感じで正論を投げ捨ててしまうのは絶対に良くないパターン。それに対してどう改善したいか、どう動くのかが明示されていないと誰も動かないし、言い方にリスペクトがないと正しかったとしても人は動かない。人は論理ではなく感情で動く。

また、「言い出しっぺがそのタスクをやるのは嫌」という意見があると違和感がある。「言い出しっぺこそそのタスクをやるべき」だし「言い出しっぺだからこそ成長できる」とも言える。

とまぁ偉そうなことを言っているが自分が20代の頃は「正論モンスター」だったときもあるし、今も意図せずリスペクトを欠いた発言をしているかもしれない。「正論モンスター」にならないために少し控えめになってしまっている部分もあるかもしれない。

必要になったらやれば良い vs 今やらないと一生やらない

Wed, 30 Jul 2025 22:30:18 +0900

私は基本的に「必要になったらやれば良いじゃん」という強めのYAGNI派閥なのだが、一方で「それって一生やらないから今やろう」という意見もそれなりに聞く。そのたびにモヤモヤしていたのだけど、最近わりと自分の中で整理できたので駄文を書く。

まず、自分は腕力があるタイプなので「必要になったらやれば良いじゃん」と思ってしまうのだが、一般的に腕力があるエンジニアは少ないので大抵の組織において「必要になったらやれば良いじゃん」のハードルが高い。

例えば軽いリファクタリング系のタスクであってもバックログに積まれっぱなしで本流の開発と並行してサブタスクをやる余裕はほとんどのチームにおいて無いのである。いわゆる改善デーのような本流の開発以外のサブタスクを集中的にやる期間を設けたとしても優先度が他のタスクに負けてしまい、腕力の総量不足も相まって「一生やらない」ことになってしまう。おそらく「それって一生やらないから今やろう」の主張の人はこういった経験が強いのだと思うし、シニアエンジニア＝腕力タイプというわけではないので、シニアかどうかに限らずこういった意見はあるのかもしれない。

というわけで、理想的にはYAGNIは良いと思っているし、これからの考え方としてもベースに置きつつも、現実的には開発リソースは有限かつそこまで高くないのが常なので少し過剰かもしれないけど今やっておく、が実は後々良い結果をもたらすこともあるのかもしれないし、その主張も理解できるかもなぁと思ったのであった。（とはいえ過剰な設計が保守性など後々悪い結果をもたらすことが多いと経験上感じるので、そのあたりと折り合いを付ける必要はある）

また、この件に限らず「自分が手を動かすなら」ではなく「他の人が手を動かすなら」とかそういう視点で考えるとチームで認識を揃えるときにもう少し現実的な落とし所が見つかるのかもなぁと思っていたりする。

リスクを取る人は凄いしカッコいい

Mon, 28 Jul 2025 23:00:00 +0900

リスクを取る人は凄いしカッコいい。と最近思ったので駄文を書く。

リターンがあるからこそリスクを取るし、大きなリターンを取ろうとすればするほどリスクも伴う。

例えば

新しい技術を使うことで課題解決したり新たな知見・経験を得ることができるリターンがある一方で失敗するリスクがある
価値のある難しいタスクをやることは失敗する可能性も高い
技術的に正しいことをやっていても、多少のハレーションを生むかもしれない
そのアプローチが短期的にはうまくいくが中長期的にはうまくいかないかもしれない
中長期的に施行している（しようとしている）タスクがうまくいかないかもしれない

などなど、仕事をしていると日々大小さまざまなリスクと向き合うことになる。

ここで言っているリスクはビジネス的な損失だけではなく失敗による自分あるいは他者からのネガティブな感情も含んでいる。

そもそも失敗というのはただの行動した出力結果に過ぎないので、そうネガティブに感じなくても良いのだが、それをわかっていても当の本人はそういったニュートラルな感情になりにくい。

数カ月・数年後には成長のきっかけだなと思えることであっても、その当時はそんな感情には一切ならないことが多い。

そもそもその案件やタスクをやるべきではなかったのではないか？と思ってしまうこともあるだろう。

しかし、「現状をよりよくする」ことを目的に実際に行動をしたのだから行動していない人よりも称賛されても良いような気がしている。

逆に、大きなリターンのためにリスクを取った人に対して、安全なところから批評・批判されているのを見るのはあまり気分が良いものではない。

というわけで改めてリスクを取っている人は凄いなと思ったし、自分も適切にリスクテイクしていかないとなと思うのだった。

安定して回っている良いチームの定義

Sun, 27 Jul 2025 21:59:18 +0900

自分が入らなくてもうまく回っていて安心して案件を任せられるな、という良いチームの定義について考えてみた。

チームになっていること

チーム内で助け合う風土やコミュニケーションが十分にできていること。

朝会など頻度の高いコミュニケーションを行っていたり、技術的な議論やドメインの共有ができていること。

技術云々の前にこれができていないと、チームで物事を進めれず、生産性・開発物の質とスピードが圧倒的に落ちてしまうのでなかなか厳しい。

技術基盤ができていること

アプリケーションのコード基盤、CI/CDやローカル開発環境、コンテナやIaCなど変更に強いインフラ基盤、監視・アラートなどなど、最低限の基盤ができていること。アプリケーションコードのテストを書く習慣があること。

あるいはこれからできる素養があり、技術的に強いメンバーが参画したり、チームとして基盤技術をキャッチアップして現実に適用する能力があること。

プロダクトエンジニアリングで価値を出していくには一定以上の技術基盤は必要。質とスピードに直結するし、オブザーバビリティ・セキュリティ・パフォーマンスなどは安定して運用するうえで重要。チーム外のシニアエンジニアに一時的に手を借りて技術基盤を作ってもらったとしても、その技術基盤に対してオーナーシップを持って積極的に保守・運用・改善を行うことが大事。

チーム外の有識者に適切なコミュニケーション・相談ができること

チームの経験不足を補う手段としてチーム外の有識者に適切なコミュニケーション・相談ができること。また、技術者だけではなく、ビジネスのステークホルダーとのコミュニケーションが円滑にできていること。

ビジネスを回していくうえで、技術者・非技術者問わずステークホルダーと適切にコミュニュケーションするスキルは大事。または、フォローしやすい体制を整えていくことも大事。

良いチームは誰が作るか

良いチームは「チームメンバーが作る」側面もあるが、そうなるように適切にフォローする・しやすい体制を整えるのが大事。

技術共有・ドメイン共有の仕組みを最初に整備してリーディングする。
技術基盤を整えるのにシニアエンジニアが一時的にお手伝いする。
コミュニケーションのフックを作りやすいように1on1を設定してあげる。

などなど。

物事がうまく進まないパターン

Thu, 19 Jun 2025 22:40:00 +0900

抽象的なプロジェクトでうまく物事が進まないなぁというのはよくある。

進まない、あるいはプロジェクトが頓挫してしまうよくある理由を雑にまとめてみた。

締切がない

締切があれば何かしらのアウトプットは生みやすい。アウトプットがあればフィードバックを受けて次のステップに進むことができる。

逆に締め切りがないとずっと議論をして物事が進まない。トップダウン的に締め切りを切ってもらうのが一番楽だが、ボトム的にマイルストーンを定義して進めていくことも大事。

シンプルにして最重要かも。

議論が空中戦になりがち

議論が空中戦になって、今議論すべき課題、次に決めるべき課題があやふやになったりすると危ない。システムで言うと、プロトタイプ的な動くものが無いと議論が空中戦になりがちで、ドメインを熟知している人同士がずっと話しがち。動くものがあれば、それを見て共通認識を作れるし、見て初めて分かることもあるしもっと物事を進められる。

理想を追いすぎてしまう

これは「締切がない」に関連していて、「締切がない」と理想を追いすぎてしまい要件や考えるべきこと、議論すべきことが増えてしまう。理想を追う議論はとても大事だが、追いすぎて時間を使ってしまうのも危険だと思う。抽象的なプロジェクトこそ現実的で具象的なタスクやシステムに落とし込んでトライ＆エラーで漸進的に進めるのが良い。まずは20点くらいのプロトタイプを作って、議論してフィードバックを受けてそれを60点にしてリリースするイメージ。

アサインが中途半端

そのプロジェクトが主務ではない場合、手を動かしたりじっくり考える時間無いと物事が進まない。

ステークホルダーが多い

MTGの参加人数が10人前後になると「議論が空中戦になりがち」「理想を追いすぎてしまう」などが発生する。

決める権限が無い

決める権限＝決定し、遂行し、リスクを背負うメンバーがいないのも危ない。これも「締切がある」と、決定せざるを得ないし、それまでに情報をある程度集めないといけないので物事が進む。

自動テストについて思っていることメモ

Thu, 19 Jun 2025 00:10:00 +0900

自動テストについて思っていることを雑に書いてみる

なぜテストコードを書くのか

自動テストは主に「コードを変更した際の予期せぬ不具合を防ぐ」「各コンポーネントが期待通り動くことを保証する」という目的を達成するためにあると思っている（設計のカナリアなどは一旦ここでは除外）。 有効なテスト を書くことで、新規コードの不具合を未然に防ぎ、既存コードを安全に変更できるようになり、結果としてアウトプットの質とスピードが上がる。手法はさておき、これらの目的を満たすテストを書くことが重要だ。

内側のテストと外側のテスト

内側のテスト（単体テスト）を書くだけではリグレッションテストができないため、外側のテスト（インテグレーションテスト・E2Eテスト）も書いたほうが良い。たとえば、あるAPIエンドポイントの一部の処理を担うクラス・メソッドの変更を安全に行うにはインテグレーションテストが書かれていないとAPIとしての動作保証ができない。内側のテストと外側のテストの検証内容が一致するのであれば外側のテストだけ書くほうが保守も考えるとコスパが良い。もちろん、境界値テストなど処理パターンの複雑さによっては外側のテストだけではデータの用意が煩雑になったりテスト時間が伸びる可能性があるため、その場合は内側のテストでカバーすると良い。

モック

外側・内側どちらのテストにおいてもモックは避けたほうが良い。モックは開発者の自作自演のテストになり、リグレッションテストの効果が薄れる。さらに、モックするメソッドの変更に追従する必要があり壊れやすいテストになるため保守性が下がる。モックしない場合はテストデータなどを事前に用意する必要があるが、今どきのフルスタックフレームワークであれば苦労せずテストデータの作成ができるはずだ（テストのしやすさで技術選定するべきとも言える）。むしろ、アプリケーションはデータが中心なので、データを用意しなければ本質的なテストはできない。DBアクセスなどでテスト時間が伸びがちだが、並列化やCIでの自動テストの対象を限定するなどやりようは色々ある。フィードバックの速さが開発者体験的に大事というのは理解できるが、だからといってモックにしてしまうのは本来の目的を見失っていると思う。そういうわけで、モックはHTTPリクエストなどコンテナ等で用意できない要素に絞るなど最小限の利用にすべきだ。

privateメソッドのテスト

内側のテストと外側のテストと考え方は同じで、privateメソッド（内側）をテストしたい場合、ロジックが単純であればpublicメソッド（外側）経由のテストで十分だ。privateメソッドのロジックが複雑で、publicメソッドのテストでやるにはコストがかかるようなケースでは単体テスト（内側のテスト）を行うようにprivateメソッドをテストしても良い。ただし、別クラスにメソッドを適切に移譲できないかどうかは検討する必要がある。ドメインモデル貧血になっていないかは注意が必要で、privateメソッドの処理は概ね既存モデルに移管できることも少なくはなさそう。

テストのために可視性を緩めるかどうか問題

前モデルにも移譲しづらく、クラス分けするほどでもない場合はprivateメソッドのテストをするのは良いと思う。テストをする際はリフレクションを使ってもよいが、可視性を上げて呼び出せるようにしても概ね問題ないように思う。

Java(Guava)やFlutterにはVisibleForTestingアノテーションがあり、テスト用に可視性を上げていることが一目でわかるようにできるし、静的解析でテスト以外で呼び出している場合に警告を出すことも可能だ。

ちなみにPHP(PHPStan)でも同様のアノテーションを作ってみたので良ければ使ってみてほしい。 https://github.com/tzmfreedom/phpstan-visible-for-testing

privateメソッドのテストは壊れやすい？

privateメソッドは公開インターフェースじゃないので、privateメソッドを削除したりインターフェースを変更したり振る舞いを変えたらテストも大幅に変更する必要がある。

テストしたいprivateメソッドがあるということはそのドメインに対して重要なロジックが含まれているということだ。単純なロジックであればpublicメソッド経由でテストすれば良いし、複雑なロジックだからこそprivateメソッドに分割してテストをしたいということだ。その複雑で重要なドメインロジックを有するprivateメソッドを変更するというのはそれなりに大工事をしているわけで、その周辺のテストが壊れるのは想定内であるべきだしテストが落ちること自体は良いことだ。また、もともとのprivateメソッドのテスト自体は「内部テスト」として価値を出していたのではないだろうか。

privateメソッドをモックをしなければインターフェースやメソッドの削除をしても既存の外側のテストは壊れないし、偽陰性・偽陽性は発生しない。

責務分離＝クラス新規作成をすべきかどうか問題

privateメソッドをテストしたくなったら、別のクラスを新規作成して、そのクラスにメソッドを実装し呼び出す（移譲する）べきという主張があると思う。これはドメインモデル貧血を防ぐためにも概ね同意ではあるもののモデルに属しづらい処理がある場合、毎回クラスを新規作成するとそれはそれで読み手も書き手もやりづらくないかという気持ちもある。また、クラス新規作成したところで結局同じメソッドが場所を移動しただけになるので、保守性・可読性を考えてリファクタリングを選択すべき。

余談: PHP/LaravelのFacade

LaravelのFacadeって嫌われがちだが、モックしやすいので良い選択だと思っている。例えばHTTP Facadeを使ってくれれば結合テストを後から書くのがめっちゃ楽。逆にcurlを直接使っていたり、Guzzleをその場でインスタンス生成していたりすると大変。良い感じにDIしてくれれば良いだが、現実はそんなに甘くない…。

まとめ

とにかく 有効なテスト を書くことが大事。経験上、有効なテストが十分に書かれていないアプリケーションはとても多い。体感7割以上。レガシーコードと言われているアプリケーションのほとんどがテストが書かれていない。テストがないからコードを安全に変更できない、安全に変更できないからミドルウェア・ライブラリがアップデートできず、顧客に価値提供ができない、といった形だ。また、書かれていてもモックだらけだったりして真にリグレッションテストができていないコードに出くわすことも少なくない。

テスト時間が遅くなる、テストの保守性が悪い（壊れやすいテストがある）という悩みは本当に幸せな悩みだと思う。テストが無いアプリケーションはテストを増やして防波堤を作るまでの量的な壁があるし、テストを書く文化を根付かせるのはより難易度が高い。だからこそエンジニアにはハードスキルとしてテストを書くスキルを磨いてほしいと思っている。テスト駆動開発じゃなくても全く問題ない。生成AIだとテスト書くのめっちゃ楽だし。原理主義に陥らずテストを書く経験を増やすことが大事。

対内的アウトプットの重要性

Wed, 18 Jun 2025 23:10:00 +0900

エンジニアはアウトプットが大事とよく言われる。

この文脈ではXやブログ記事の投稿、登壇など対外的なアウトプットを指すことが多い。

しかしながら業務においては以下のような対内的なアウトプットの方が必須スキルだと思っている。

自分のやっていることの発信
自分の考え・感情の表明
技術・ビジネスドメインの言語化

1 に関してはフルリモート環境において、自分の周りの人が何をやっているかわからない、という状況がよくある。この状況を改善するには一人ひとりが自分のやっていることを発信していくことだと思っている。 timesチャンネル はその方法の１つだと思うし、デイリーMTGがあれば、やっていることの発信が強制されるのでチーム内で何をやっているのかを把握できる。

2 の自分の考え・感情を表明していくのも大事だ。現在の状況や出来事に対してどのように課題に感じているのか、どう解決しようとしているのか、何に困っているのか、といったことを知ることで、解決に向けてフォローしたりされたり、あるいは共感を得ることで少し気が楽になるかもしれない。デイリーMTGにおける「困りごと」「相談事項」の共有や上長とのMTGではこのアウトプットに該当する。振り返りも考え方を共有する貴重な機会だ。

3 の言語化＝ドキュメンテーションは、自分の中でものごとを整理できるだけでなく、組織や未来の自分にとって重要な資産となる。 READMEやwiki、ADR以外にもMTGの議事録を書くことも該当する。

こうして考えると 透明性 と言われるものは、 各人のアウトプット の努力やそれを推進・強制する仕組み（デイリーMTG、振り返り、1on1など）が重要なのかもしれない。もし、デイリーMTGや振り返りや1on1が無かったり頻度が十分ではない場合は、透明性が失われチーム感が無くなり当事者意識も無くなってしまうかもしれない。当たり前のようにある仕組みは意外と大事なんだなぁと改めて思ったりしたのであった。

技術選定の難しさメモ

Wed, 18 Jun 2025 23:00:00 +0900

技術選定に解はなく、組織やユースケースなど様々なファクターが絡み合う、という大前提の上で自分は枯れた技術を選びがちである。

例えば不確実性の高い要件であれば、チームや自分の経験値が高い枯れたフルスタックフレームワークを選択するし、なるべくシステムをシンプルに認知負荷が上がらないようにする気持ちがある。その枯れた技術の中で少しずつ新しい技術を取り入れてリスクテイクしている感じ。

流行りの技術＝枯れていない技術とすると、流行りの技術は以下のような懸念があるのかなと思っている。

なにか技術的な問題が発生したときに自力で解決できる技術力が必要
流行りの技術が何かに秀でている要素が合ったとして、トレードオフがある可能性があり、結果枯れた技術を採用するのとプラマイゼロのケースがある
「流行りの技術を使って楽しい」と思えるのはせいぜい数ヶ月から１年くらいな気がする

一方で枯れた技術を選択し続けることで、学習機会を奪ってしまっているのではないかという懸念もある。既存技術の延長でしか成長できないのではないか、とか。

また、以下のようなケースであれば新しい技術を採用するのは良いと思う。

なにかパフォーマンスの問題などでマイクロサービスで局所的に解消できるケース
その技術選定にチームが中長期的に覚悟を持って取り組めるケース
なにか問題が発生したときに捨てれる、あるいはビジネスに全く影響なく作り直すなどなんとかする技術力を有しているケース。あるいはドメイン的に作り直しが全く問題ない、リスクがないケース。

ビジネス要件と技術選定が紐づくため、枯れた技術で解決できない課題があれば積極的に新しい技術を検討すべきだし、採用など中長期的に覚悟を持って取り組めるのであれば止めるものは何もないのかな、といった感じ。

逆に避けるべきケースとしては↓こんな感じ。

チームとしてその技術を使ってビジネスを遂行できない
中長期的なPros/Consを検討できていない。例えば運用負荷・認知負荷を全く検討できていない、とか。

とはいえ、技術選定に解はない（再掲）なので難しいんだよなぁ。

Terraform業務で触ってみたメモ

Wed, 18 Jun 2025 22:00:00 +0900

仕事で Terraform をガッツリ触る機会があったのでキャッチアップでやったことや見た資料をざっと書く。Google Cloudに適用する、というコンテキスト。

雑に書くので結構間違いあるかもだがメモということで

必要なツールをインストール

Terraformのバージョンマネージャーである tfenv をインストールして tfenv install xxx で対象バージョンのterraformをインストール。 .terraform-version ファイルを用意してバージョン切り替えする。

補完やsyntax highlightの目的で、VSCodeなどの拡張機能を適宜インストール。
HashiCorp Terraform

インストールしたら対象のワークディレクトリで terraform init してモジュールなどをダウンロード。

フォーマッタとtflintとバリデーションの整備

tflint やプロバイダーのplugin入れたり、CIやMakefileで実行したり、 tarraform-docs を導入して自動でドキュメントを生成したり。

tflint
terraform validate
terraform fmt

コマンドを叩いて色々確認

planコマンドを叩いたりapplyしてみたり

terraform plan
# 対象モジュール・リソース指定: 同時並行で色々やってるときに開発環境に試し適用するときに使ったり
terraform plan -target module.{module_name}
terraform plan -target module.{module_name}.{resource}.{resource_name}

terraform apply
terraform apply -target module.{module_name}
terraform apply -target module.{module_name}.{resource}.{resource_name}

terraform自体の勉強

基本的な書き方をキャッチアップしつつ以下の記事を読んで作法やTerraform利用時の課題感を理解

lifecycle {
 prevent_destroy = true
}

でterraformからの誤った削除を防止したりリソース自体に削除防止機能があればそれを有効化しておく。 Cloud SQLだと deletion_protection = true を指定したり。

tosetで変数を使いたい場合はキーがknown valueじゃないといけないので、outputやリソース参照などknown valueじゃない場合は keyがknown valueなmapを使ったりして対応。

リソース名は変更するとdestroy/createになるので注意。 terraform mvとかmovedブロックを使うことになる。

dataブロックを使うとproviderの情報を良い感じに使うことができて便利

GitHub Actionsによる自動plan/apply

手元でデプロイしても良いが自動化したくなったりミスオペ怖かったりするのでCI/CDした。手元でデプロイする場合も権限はCI/CDで実行するユーザ（workfload identity）にimpersonateするように調整した。

共有と定着

Thu, 02 Jan 2025 22:30:00 +0900

技術共有やドメイン共有をやっていると、共有したものがチームに定着してないなと感じることがよくある。

これは

共有内容や共有方法が良くない、分かりづらい
共有内容とチームのレベルにギャップがある
共有回数や頻度が少ないので理解・定着しない

といった理由がありそうなのだが、そもそも「共有しただけでは定着しない」という面がある。手を動かしたり自分の頭で整理して考える、経験することで初めて共有したものが定着する。

自分の経験的にも、共有されたときに内容を理解したとしても定着している感じはしない。例えば、ある運用方法について座学で共有をされるよりは、作ってもらった資料を見ながら運用を実際に経験するほうがずっと定着する。とはいえその座学による共有が無駄かというと全くそうではなくて、一度座学で概要理解したからこそ手を動かしたときに理解がしやすくなっている。

なので共有したことがゴールではなく共有した後が実は大事で

XXの開発・運用するときは資料を参考にしてください！もしわからなかったらお気軽にメンションください！
XXの技術で困ったときは自分に問い合わせください！

みたいな感じで、共有された人の次のアクション（共有されたドメインの開発・運用、技術導入など）のハードルを下げるような振る舞いと伴走が必要と感じている。

ということで、共有したものが定着しないと感じたときは共有のやり方を見直しつつ、そもそも「手を動かして経験しないと定着しない」ことを念頭に置くと少し気が楽になるかもしれない。

逆に、共有された人は積極的にアクションしていくことが大事で、詳しい人にタスクを任せようではなく、自分がやってみようという心意気が必要と感じる。ドメイン共有であれば関連するコードを時間を作って追ってみたりテストコードを書いてみる、というのも定着につなげる大事なアクションだ。

2025

Wed, 01 Jan 2025 00:00:00 +0900

2024年の振り返り

Mon, 30 Dec 2024 22:30:00 +0900

今年もええ感じに振り返っていくよ！

転職した＆仕事について

個人ブログや会社ブログにいくつか書いたが今年4月に転職した。

入社してからやったこととしてはこのあたり

担当サービスの施策開発
担当サービスの技術基盤改善
横断的な技術基盤整備

担当サービスの施策開発と技術基盤改善がメインタスクで、以下のことを目的として取り組んでいた。

担当サービス自体をグロースさせるため
担当サービスの技術基盤を整備することで他のサービスも真似しやすくなり、結果として全体的な技術基盤改善につなげるため
運用する上で足りない機能を洗い出し、横断的な技術基盤として実装推進するため
ドメインや技術的特性を知るため
自身のサービス担当者としての信頼貯金を貯めるため

個人的には特に3,4,5を期待してやっていて、来年はもう一段階広い視点で業務に取り組むことになりそうなこともあり、よりレバレッジが高そうな施策に取り組むためのファーストステップをやっていった感じ。色々タスクをこなした結果、組織やビジネスに対する解像度がかなり上がったと思う。

横断的な技術基盤整備でいうと「ログ出力」「バッチ実装」「データ変更」に関するガイドラインや「PHPStan」「PHPUnit」「Datadog APM」「CloudWatch Logs」あたりの入門向けのドキュメントを書いていたりした。中長期的に効くものだと思うので、引き続きコンテンツを増やしていけると良いなと思っている。来年はこれに加えて社内勉強会とかもちょくちょく開催できるとより良さそうかなと思っていたり。

あとは前職と同様に会社のSlackチャンネルにPHPの記事を投下していたりして、PHPがなんか得意そうな人がいるという感じでプレゼンスも上げれたんじゃないかな、多分。

一方でアンラーニングはあまりできなかった印象。ビジネス理解や業務理解を高めるところがまだ全然できていないとか、技術以外の改善施策を全然打てなかったなぁとか。Salesforceを使い倒している組織なので、Salesforceも学び直ししないといけない感じもしている。

体調面

仕事自体は全体で見ると比較的パフォーマンス出せたところがある一方で、社会人になってから一番体調を崩したんじゃないかというぐらい不調な１年だった。特に5月と12月がずっと体調悪くて大変だった。こどもが4月に保育園入園してからはこどもが体調を崩したり親に伝染ったりしはじめてそこから大きく崩れた感じがする。あるあるとはいえ中々に大変。

体調不良によってキャンセルした予定も結構あって、同月に2〜3キャンセルするとさすがに精神的にも気が滅入る感じだった。逆に予定入れなくてよかったなと思うくらいのときもあり、あまり健全な状態ではないので体調面に関しては本当にどうにかしたい。

運動もほとぼそとランニングを続けていたりしたのだが体調不良が続いて最近は全然走れてない。来年はもう少し頻度上げたい…（そのためには体調面どうにかしないと）

アウトプット

phpcon 2024に登壇した。育児の関係で２年間登壇を控えていたので、久しぶりに登壇できてとても嬉しい。前述の通り12月はめちゃくちゃ体調悪い月で、登壇もギリギリ体調が間に合った日だったので登壇のクオリティはさておき参加できて本当に嬉しかった。とはいえ体調面でトークがあまり見れず懇親会も参加できなかったのは残念だった。来年も何かしら登壇できると良いなぁというのと体調整えて全力で参加していきたい。

ブログもいくつか書けた。プライベートの方は主にLaravelのコードリーディングで、おかげで理解度はかなり上がった気がする。今後は技術に限らず色々と考え方をもう少し雑に書いていこうかなぁと思っていたりする。会社の方のブログは前述の2本。来年もこれくらい書けると良いなぁ。

その他

育児

相変わらずこどもは可愛くて楽しく過ごせている。保育園も楽しく遊んでいるようで友達が増えていたり、まだ2歳に満たないのに集団生活をしていて本当にすごいなぁという感じ。離乳食から幼児食に変わったり歩いたり話したり手が器用になったり物事を理解できるようになったり毎日成長していて驚かされている。

一方で夜泣きが本格化して大変な１年だった。特に体調不良の中やる夜泣き対応は肉体的にも本当に厳しい感じだった。

ゲーム

ゴーストオブツシマを買って全クリまで。龍が如く７外伝と龍が如く８も買ったのだが全然できていない。外伝が中盤くらいで止まっていてストーリー忘れかけているｗ

本

全然読めなかった…。来年はガツガツ読んでいきたい。

買ったもの

夜泣きなどで睡眠量が確保できないケースもあり、エアウィーヴを導入して睡眠の質を上げようとしたがもともと睡眠自体が得意だったので効果はちょっとわからない。

ちょっとした距離の移動でバス利用が面倒だったのもあり、電動自転車と普通の自転車を買った。結果、行動範囲を広げれたり、こどもを乗せてサイクリングできたのでとても良い買い物だった。バス移動だとこどもの機嫌が悪いと精神的に疲弊するのだが、自転車だと機嫌が良くてだいたい寝てくれるのでそういう意味でもとても楽。

今年の振り返り＆来年に向けて

体調面以外は公私ともに良い感じに過ごせた１年だった。会社もポジションも良い選択をしたと思っていて、今の会社でしかできない仕事・経験があり、とてもワクワクしている。今までやってきたアプローチでは通用しないところもありそうで、そこは愚直にアンラーニングしていきたいし、結果的に成長につながると確信しているので引き続き頑張っていきたい。

ということで、来年はまずは体調を整えるということが一番。その上で公私ともに楽しくできれば良いと思っている。来年は沖縄あたり旅行したいなぁ。

ということで今年も大変お世話になりました！
来年もよろしくお願いいたしまっす！！

LaravelのEloquentの仕組み: Model::find()

Wed, 24 Jul 2024 22:10:00 +0900

Laravelのコードリーディングメモ。今日はいよいよEloquent。

まずは

$hoge = HogeModel::find();

がどうやって動いているのかを見ていきます。

まず Model::__callStatic() が呼ばれ、staticメソッドはインスタンスメソッドに置き換えて実行されます。

public static function __callStatic($method, $parameters)
{
 return (new static)->$method(...$parameters);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Eloquent/Model.php#L2349-L2352

インスタンスメソッドにも find() メソッドは存在しないので __call() が呼ばれます。

public function __call($method, $parameters)
{
 if (in_array($method, ['increment', 'decrement', 'incrementQuietly', 'decrementQuietly'])) {
 return $this->$method(...$parameters);
 }

 if ($resolver = $this->relationResolver(static::class, $method)) {
 return $resolver($this);
 }

 if (Str::startsWith($method, 'through') &&
 method_exists($this, $relationMethod = Str::of($method)->after('through')->lcfirst()->toString())) {
 return $this->through($relationMethod);
 }

 return $this->forwardCallTo($this->newQuery(), $method, $parameters);
}

最終的に $this->newQuery() に処理が委譲されます。

newQuery() は対象のモデルを setModel() でセットした Illuminate\Database\Eloquent\Builder のインスタンスを生成します。

public function newQuery()
{
 return $this->registerGlobalScopes($this->newQueryWithoutScopes());
}

public function newQueryWithoutScopes()
{
 return $this->newModelQuery()
 ->with($this->with)
 ->withCount($this->withCount);
}

public function newModelQuery()
{
 return $this->newEloquentBuilder(
 $this->newBaseQueryBuilder()
 )->setModel($this);
}

public function newEloquentBuilder($query)
{
 return new Builder($query);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Eloquent/Model.php#L1487-L1490 https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Eloquent/Model.php#L1534-L1539 https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Eloquent/Model.php#L1497-L1502 https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Eloquent/Model.php#L1569-L1572 https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Eloquent/Builder.php#L1837-L1844

forwardCallTo() は $object の $method を $parameters パラメータを付けて呼び出す委譲メソッドです。ということで今回はEloquentBuilderの find() が呼ばれます。

Laravelのエラーハンドリングの仕組み

Tue, 23 Jul 2024 21:30:00 +0900

Laravelのエラーハンドリングのコードリーディングメモ。

適当なコントローラーでExceptionをスローしたときのケースを追っていきます。

Exceptionがスローされると Pipeline::prepareDestination() 内のcatch句でハンドリングされます。

protected function prepareDestination(Closure $destination)
{
 return function ($passable) use ($destination) {
 try {
 return $destination($passable);
 } catch (Throwable $e) {
 return $this->handleException($passable, $e);
 }
 };
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Pipeline/Pipeline.php#L140-L149

handleException() はExceptionHandlerに紐づくクラスをインスタンス化し、report() を呼び出しつつ render() でレスポンスを返します。

protected function handleException($passable, Throwable $e)
{
 if (! $this->container->bound(ExceptionHandler::class) ||
 ! $passable instanceof Request) {
 throw $e;
 }

 $handler = $this->container->make(ExceptionHandler::class);

 $handler->report($e);

 $response = $handler->render($passable, $e);

 if (is_object($response) && method_exists($response, 'withException')) {
 $response->withException($e);
 }

 return $this->handleCarry($response);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Routing/Pipeline.php#L40-L58

report

report() は shouldntReport() でレポートするかの判定を行い、レポート対象であれば reportThrowable() でレポートします。

public function report(Throwable $e)
{
 $e = $this->mapException($e);

 if ($this->shouldntReport($e)) {
 return;
 }

 $this->reportThrowable($e);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Foundation/Exceptions/Handler.php#L328-L337

shouldntReport() ではスローされたExceptionが $dontReport $internalDontReport のインスタンスであればレポートしない処理が入っています。

protected function shouldntReport(Throwable $e)
{
 if ($this->withoutDuplicates && ($this->reportedExceptionMap[$e] ?? false)) {
 return true;
 }

 $dontReport = array_merge($this->dontReport, $this->internalDontReport);

 if (! is_null(Arr::first($dontReport, fn ($type) => $e instanceof $type))) {
 return true;
 }

 return rescue(fn () => with($this->throttle($e), function ($throttle) use ($e) {
 if ($throttle instanceof Unlimited || $throttle === null) {
 return false;
 }

 if ($throttle instanceof Lottery) {
 return ! $throttle($e);
 }

 return ! $this->container->make(RateLimiter::class)->attempt(
 with($throttle->key ?: 'illuminate:foundation:exceptions:'.$e::class, fn ($key) => $this->hashThrottleKeys ? md5($key) : $key),
 $throttle->maxAttempts,
 fn () => true,
 $throttle->decaySeconds
 );
 }), rescue: false, report: false);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Foundation/Exceptions/Handler.php#L396-L424

Laravelのページネーションの仕組み

Thu, 04 Jul 2024 22:00:00 +0900

Laravelのページネーションのコードリーディングメモ。

$users = User::paginate(15);

<div class="container">
 @foreach ($users as $user)
 {{ $user->name }}
 @endforeach
</div>
 
{{ $users->links() }}

ページネーションデータの準備

Builder::paginate() で処理されます。

public function paginate($perPage = null, $columns = ['*'], $pageName = 'page', $page = null, $total = null)
{
 $page = $page ?: Paginator::resolveCurrentPage($pageName);

 $total = value($total) ?? $this->toBase()->getCountForPagination();

 $perPage = ($perPage instanceof Closure
 ? $perPage($total)
 : $perPage
 ) ?: $this->model->getPerPage();

 $results = $total
 ? $this->forPage($page, $perPage)->get($columns)
 : $this->model->newCollection();

 return $this->paginator($results, $total, $perPage, $page, [
 'path' => Paginator::resolveCurrentPath(),
 'pageName' => $pageName,
 ]);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Eloquent/Builder.php#L920-L939

Paginator::resolveCurrentPage() では Paginator::currentPageResolver() で設定したClosureを使ってページ番号を取得します。

Paginator::currentPageResolver(function ($pageName = 'page') use ($app) {
 $page = $app['request']->input($pageName);

 if (filter_var($page, FILTER_VALIDATE_INT) !== false && (int) $page >= 1) {
 return (int) $page;
 }

 return 1;
});

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Pagination/PaginationState.php#L19-L27

page のリクエストパラメータから番号を取得、バリデーションした上で値を返しています。

Builder::getCountForPagination() ではモデルのカウントを取っています。 https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Query/Builder.php#L3034-L3078

Builder::forPage() ではページ番号、1ページあたりのレコード数を使ってOFFSET/LIMITでレコードを取得します。

public function forPage($page, $perPage = 15)
{
 return $this->offset(($page - 1) * $perPage)->limit($perPage);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Query/Builder.php#L2596-L2599

BuildsQueries::paginator() ではLengthAwarePaginatorクラスのインスタンスを作成します。

protected function paginator($items, $total, $perPage, $currentPage, $options)
{
 return Container::getInstance()->makeWith(LengthAwarePaginator::class, compact(
 'items', 'total', 'perPage', 'currentPage', 'options'
 ));
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Database/Concerns/BuildsQueries.php#L492-L497

ページネーションの表示

LengthAwarePaginator::links() は LengthAwarePaginator::render() を呼び出しています。

Laravelの認証の仕組み

Wed, 26 Jun 2024 22:00:00 +0900

Laravelの認証周りのコードリーディングメモ。

↓こんな感じなパターンを見ていく

Route::get('/resources', function () {
 $user = Auth::user();
 // ...
})->middleware('auth');

Route::post('/login', function ($request) {
 if (Auth::attempt($request->all()) {
 // ...
 }
});

認証チェック

Illuminate\Auth\Middleware\Authenticate ミドルウェアでチェックしています。

public function handle($request, Closure $next, ...$guards)
{
 $this->authenticate($request, $guards);

 return $next($request);
}

protected function authenticate($request, array $guards)
{
 if (empty($guards)) {
 $guards = [null];
 }

 foreach ($guards as $guard) {
 if ($this->auth->guard($guard)->check()) {
 return $this->auth->shouldUse($guard);
 }
 }

 $this->unauthenticated($request, $guards);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Auth/Middleware/Authenticate.php#L60-L65 https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Auth/Middleware/Authenticate.php#L76-L89

Illuminate\Auth\AuthManager::guard($guard)->check() でチェックして認証が通っていなければ unauthenticated() メソッド経由で AuthenticationException をスローします。

guard() は引数がnullの場合は getDefaultDriver() でdriver名を取得して resolve() した値を取得します。

public function guard($name = null)
{
 $name = $name ?: $this->getDefaultDriver();

 return $this->guards[$name] ?? $this->guards[$name] = $this->resolve($name);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Auth/AuthManager.php#L66-L71

resolve() はconfigから取得してdriverを取得して各driverメソッドを呼び出します。

protected function resolve($name)
{
 $config = $this->getConfig($name);

 if (is_null($config)) {
 throw new InvalidArgumentException("Auth guard [{$name}] is not defined.");
 }

 if (isset($this->customCreators[$config['driver']])) {
 return $this->callCustomCreator($name, $config);
 }

 $driverMethod = 'create'.ucfirst($config['driver']).'Driver';

 if (method_exists($this, $driverMethod)) {
 return $this->{$driverMethod}($name, $config);
 }

 throw new InvalidArgumentException(
 "Auth driver [{$config['driver']}] for guard [{$name}] is not defined."
 );
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Auth/AuthManager.php#L81-L102

LaravelのRouteパラメータのバインディングの仕組み

Tue, 25 Jun 2024 22:30:00 +0900

LaravelのSubstituteBindingsのコードリーディングメモ。

まずは暗黙的なバインディング・明示的なバインディングの以下のようなシンプルなパターンで見ていきます。

Route::get('/hoges/{hoge}', function (Request $request, Hoge $hoge) {
 return view('welcome');
});

Route::get('/foos/{foo}', function (Request $request, $foo) {
 return view('welcome');
});

public function boot(): void
{
 Route::bind('foo', function (string $value) {
 return tap(new \stdClass(), function ($obj) use ($value) {
 $obj->hello = $value;
 });
 });
}

Illuminate\Routing\Middleware\SubstituteBindings でパラメータのバインドが行われます。

public function handle($request, Closure $next)
{
 try {
 $this->router->substituteBindings($route = $request->route());

 $this->router->substituteImplicitBindings($route);
 } catch (ModelNotFoundException $exception) {
 if ($route->getMissing()) {
 return $route->getMissing()($request, $exception);
 }

 throw $exception;
 }

 return $next($request);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Routing/Middleware/SubstituteBindings.php#L39

明示的バインディング

まずは、明示的なバインディング（上記の foo の方）を見ていきます。

Illuminate\Routing\Router::substituteBindings() で明示的なバインドが行われます。

public function substituteBindings($route)
{
 foreach ($route->parameters() as $key => $value) {
 if (isset($this->binders[$key])) {
 $route->setParameter($key, $this->performBinding($key, $value, $route));
 }
 }

 return $route;
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Routing/Router.php#L937-L946

\Illuminate\Routing\Route::parameters() は { 'hoge' => 1 } のようなarrayが入ります。

boot() 内で Illuminate\Routing\Router::bind() を呼び出すと $binders プロパティのキーに $binder のClosureがセットされます。

Laravelのスロットリングの仕組み

Thu, 20 Jun 2024 22:30:00 +0900

LaravelのThrottleRequestのコードリーディングメモ。

今回はこんな感じなコードで何が起きているかを見ます。

Route::middleware(['throttle:api'])->group(function () {
 // ...
});

/**
 * Bootstrap any application services.
 */
protected function boot(): void
{
 RateLimiter::for('api', function (Request $request) {
 return Limit::perMinute(60)->by($request->user()?->id ?: $request->ip());
 });
}

throttle は \Illuminate\Routing\Middleware\ThrottleRequests のエイリアスなのでそこから見ていきます。

throttle:api のコロンのあとは引数になるので、以下の $maxAttempts は api が入ります。

public function handle($request, Closure $next, $maxAttempts = 60, $decayMinutes = 1, $prefix = '')
{
 if (is_string($maxAttempts)
 && func_num_args() === 3
 && ! is_null($limiter = $this->limiter->limiter($maxAttempts))) {
 return $this->handleRequestUsingNamedLimiter($request, $next, $maxAttempts, $limiter);
 }

 return $this->handleRequest(
 $request,
 $next,
 [
 (object) [
 'key' => $prefix.$this->resolveRequestSignature($request),
 'maxAttempts' => $this->resolveMaxAttempts($request, $maxAttempts),
 'decaySeconds' => 60 * $decayMinutes,
 'responseCallback' => null,
 ],
 ]
 );
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Routing/Middleware/ThrottleRequests.php#L82-L102

throttle:api の場合は最初のif分岐に入ります。

handleRequestUsingNamedLimiter() は $limiter() を呼び出し RateLimiter::for() で定義したClosureの戻り値を取得し、その設定を使ってリクエストの閾値チェックを行っています。

protected function handleRequestUsingNamedLimiter($request, Closure $next, $limiterName, Closure $limiter)
{
 $limiterResponse = $limiter($request);

 if ($limiterResponse instanceof Response) {
 return $limiterResponse;
 } elseif ($limiterResponse instanceof Unlimited) {
 return $next($request);
 }

 return $this->handleRequest(
 $request,
 $next,
 collect(Arr::wrap($limiterResponse))->map(function ($limit) use ($limiterName) {
 return (object) [
 'key' => self::$shouldHashKeys ? md5($limiterName.$limit->key) : $limiterName.':'.$limit->key,
 'maxAttempts' => $limit->maxAttempts,
 'decaySeconds' => $limit->decaySeconds,
 'responseCallback' => $limit->responseCallback,
 ];
 })->all()
 );
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Routing/Middleware/ThrottleRequests.php#L115-L137

LaravelのSession/CSRFの仕組み

Wed, 19 Jun 2024 21:30:00 +0900

Laravelのsession/csrfまわりのハンドリング何しているかのコードリーディングメモ。

Session

Illuminate\Session\Middleware\StartSession ミドルウェアでセッションのハンドリングをしています。

public function handle($request, Closure $next)
{
 if (! $this->sessionConfigured()) {
 return $next($request);
 }

 $session = $this->getSession($request);

 if ($this->manager->shouldBlock() ||
 ($request->route() instanceof Route && $request->route()->locksFor())) {
 return $this->handleRequestWhileBlocking($request, $session, $next);
 }

 return $this->handleStatefulRequest($request, $session, $next);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Session/Middleware/StartSession.php#L51-L65

getSession() ではクッキーからセッションIDを取得し、 Illuminate\Session\Store::setId() で取得したセッションIDをセットします。

public function getSession(Request $request)
{
 return tap($this->manager->driver(), function ($session) use ($request) {
 $session->setId($request->cookies->get($session->getName()));
 });
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Session/Middleware/StartSession.php#L157-L162

setId() は指定したIDを設定するか、新しくセッションIDを発行します。

public function setId($id)
{
 $this->id = $this->isValidId($id) ? $id : $this->generateSessionId();
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Session/Store.php#L649-L652

セッションIDを設定したあとは、 handleStatefulRequest() を呼び出します。

protected function handleStatefulRequest(Request $request, $session, Closure $next)
{
 $request->setLaravelSession(
 $this->startSession($request, $session)
 );
 
 // ...(省略)...

 $response = $next($request);

 $this->storeCurrentUrl($request, $session);

 $this->addCookieToResponse($response, $session);

 $this->saveSession($request);

 return $response;
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Session/Middleware/StartSession.php#L110-L133

setLaravelSession() では $request->session() などのリクエストクラスからのsession呼び出しができるようにしています。

startSession() では Store::start() => Store::loadSession() という感じで呼び出していて、セッションIDを使ってセッションストレージからセッションを取り出して $attributes プロパティにセットしています。

LaravelのValidationExceptionのハンドリングの仕組み

Tue, 18 Jun 2024 22:00:00 +0900

Laravelの ValidationException のハンドリングが何をやっているのかコードリーディングメモ。

Illuminate\Foundation\Exceptions\Handler のこの部分。

public function render($request, Throwable $e)
{
 // ...(省略)...

 return $this->finalizeRenderedResponse($request, match (true) {
 $e instanceof HttpResponseException => $e->getResponse(),
 $e instanceof AuthenticationException => $this->unauthenticated($request, $e),
 $e instanceof ValidationException => $this->convertValidationExceptionToResponse($e, $request),
 default => $this->renderExceptionResponse($request, $e),
 }, $e);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Foundation/Exceptions/Handler.php#L584

convertValidationExceptionToResponse() ではJSONを返さない場合は invalid() が呼ばれます。

protected function convertValidationExceptionToResponse(ValidationException $e, $request)
{
 if ($e->response) {
 return $e->response;
 }

 return $this->shouldReturnJson($request, $e)
 ? $this->invalidJson($request, $e)
 : $this->invalid($request, $e);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Foundation/Exceptions/Handler.php#L720-L729

invalid() はRedirectResponseを作成しています。

protected function invalid($request, ValidationException $exception)
{
 return redirect($exception->redirectTo ?? url()->previous())
 ->withInput(Arr::except($request->input(), $this->dontFlash))
 ->withErrors($exception->errors(), $request->input('_error_bag', $exception->errorBag));
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Foundation/Exceptions/Handler.php#L738-L743

withInput() は Illuminate\Session\Store::flashInput() を呼び出し、 _old_input にflashデータとして入力値をセットします。これによって入力値がリダイレクトGET後の一回限りのセッションデータとして利用できるようになります。

public function withInput(array $input = null)
{
 $this->session->flashInput($this->removeFilesFromInput(
 ! is_null($input) ? $input : $this->request->input()
 ));

 return $this;
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Http/RedirectResponse.php#L74-L81 https://github.com/laravel/framework/blob/11.x/src/Illuminate/Session/Store.php#L534-L537

withErrors() も Illuminate\Session\Store::flash() を叩いて ValidationException::errors() の内容をゴニョゴニョしてセットしてます。

public function withErrors($provider, $key = 'default')
{
 $value = $this->parseErrors($provider);

 $errors = $this->session->get('errors', new ViewErrorBag);

 if (! $errors instanceof ViewErrorBag) {
 $errors = new ViewErrorBag;
 }

 $this->session->flash(
 'errors', $errors->put($key, $value)
 );

 return $this;
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Http/RedirectResponse.php#L131-L146

Laravelのflashの仕組み

Tue, 18 Jun 2024 21:30:00 +0900

Laravelの RedirectResponse::with() のflashが何をやっているのかコードリーディングメモ。

RedirectResponse::with() は Illuminate\Session\Store::flash() を呼び出します。

public function with($key, $value = null)
{
 $key = is_array($key) ? $key : [$key => $value];

 foreach ($key as $k => $v) {
 $this->session->flash($k, $v);
 }

 return $this;
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Http/RedirectResponse.php#L35-L51

flash() では以下のようなことをやっています。

$attributes プロパティに属性をセット
_flash.new に $key を追加
_flash.old から $key を削除

public function flash(string $key, $value = true)
{
 $this->put($key, $value);

 $this->push('_flash.new', $key);

 $this->removeFromOldFlashData([$key]);
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Session/Store.php#L443-L450

例えば with(['message' => 'OK']) という呼び出しをした場合、

key	value
message	OK
_flash.new	[message]
_flash.old	[]

という状態になります。

この Illuminate\Session\Store は Illuminate\Session\Middleware\StartSession::saveSession() で save() メソッドが呼ばれます。 https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Session/Middleware/StartSession.php#L245

save() では以下の処理を行ってます。

_flash.old に入っているキーの値をセッションストレージから削除
_flash.old に _flash.new の値（flashのキー配列）をセット
_flash.new の値をクリア
$attributes の値をセッションストレージに格納

public function save()
{
 $this->ageFlashData();

 $this->prepareErrorBagForSerialization();

 $this->handler->write($this->getId(), $this->prepareForStorage(
 $this->serialization === 'json' ? json_encode($this->attributes) : serialize($this->attributes)
 ));

 $this->started = false;
}

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Session/Store.php#L166-L177

LaravelのFormRequestの仕組み

Mon, 17 Jun 2024 23:30:00 +0900

LaravelのFormRequestの仕組みを調べてみたので備忘録。 Laravelのバージョンは11.0.7です。

ServiceProviderでのコールバック関数の設定

ServiceProviderでFormRequestのインスタンス化とバリデーションする処理の追加をしています。

Illuminate\Foundation\Providers\FoundationServiceProvider経由でIlluminate\Foundation\Providers\FormRequestServiceProviderが呼ばれます。

 /**
 * Bootstrap the application services.
 *
 * @return void
 */
 public function boot()
 {
 $this->app->afterResolving(ValidatesWhenResolved::class, function ($resolved) {
 $resolved->validateResolved();
 });

 $this->app->resolving(FormRequest::class, function ($request, $app) {
 $request = FormRequest::createFrom($app['request'], $request);

 $request->setContainer($app)->setRedirector($app->make(Redirector::class));
 });
 }

https://github.com/laravel/framework/blob/v11.0.7/src/Illuminate/Foundation/Providers/FormRequestServiceProvider.php#L27-L38

Container::resolving() では $resolvingCallbacks プロパティにコールバック関数がセットされます。

 /**
 * Register a new resolving callback.
 *
 * @param \Closure|string $abstract
 * @param \Closure|null $callback
 * @return void
 */
 public function resolving($abstract, ?Closure $callback = null)
 {
 if (is_string($abstract)) {
 $abstract = $this->getAlias($abstract);
 }

 if (is_null($callback) && $abstract instanceof Closure) {
 $this->globalResolvingCallbacks[] = $abstract;
 } else {
 $this->resolvingCallbacks[$abstract][] = $callback;
 }
 }

https://github.com/laravel/framework/blob/11.x/src/Illuminate/Container/Container.php#L1163-L1174

PHPStanの拡張機能の作り方

Thu, 11 Apr 2024 22:30:00 +0900

PHPStanの拡張機能の作り方をざっと調べてみたので備忘録。拡張機能といっても色々あるが、ライブラリ以外のプロダクションコードでよく使いそうな Custom Rules Class Reflection Extensions Dynamic Return Type Extensions の３つについて書いていく。

詳細は公式ドキュメントを参照。

Custom Rules

検証ルールを独自に作成できる拡張機能。PHPStan\Rules\Rule インターフェースをimplementしたクラスを実装すればOKで、どのNodeに対して（getNodeType()）、どういう検査を行うのか（processNode）を記述していく。検査時にエラーがあれば processNode() でエラー文字列の配列を返せば良い。

例えばメソッド呼び出しに対して検査したい場合は以下のような感じで実装する。

<?php declare(strict_types = 1);

namespace App;

use PhpParser\Node;
use PhpParser\Node\Expr\MethodCall;
use PHPStan\Analyser\Scope;
use PHPStan\Rules\Rule;

class XXXRule implements Rule
{
 public function getNodeType(): string
 {
 // ここに検査対象のノードのクラス名を記述する
 return MethodCall::class;
 }

 public function processNode(Node $node, Scope $scope): array
 {
 // エラーがあれば return ['エラーメッセージ']; という感じで文字列配列を返す。
 // エラーがなければ return []; を返す。
 return [];
 }
}

$node は対象のASTノードで getNodeType() で返したクラスのオブジェクトが入る。上記例だと$nodeに入る MethodCall クラスはメソッド名を表す $name、レシーバーを表す $var、引数を表す $args の3つのノードを持っているので、これらのプロパティを使って検査をしていくことになる。

$scope はそのノードに対するスコープ／状態を表している。例えばメソッドAで $var = 'hoge'; メソッドBで $var = 1; といった形で同名の変数が異なる型、コンテキストで利用されている場合、メソッドA内では文字列型、メソッドB内では数値型として扱われるべきだが、これは変数名だけでは確定できない。そのため、そのスコープ／状態に応じて型を検査する必要があるが、それを表すオブジェクトが Scope インターフェースの$scope変数である。例えば $scope->getVariableType('変数名') という形で呼び出すと、そのスコープに応じた変数名の型を抽出できる。他にも $scope->getFile() でそのノードの元ファイル名、 $scope->getNamespace() で名前空間を取得できる。

3回目の転職の備忘録

Wed, 13 Mar 2024 07:30:00 +0900

5ヶ月間ほど3回目の転職活動していたので備忘として雑に残しておく。

関連する退職エントリはこちら。

利用した転職媒体など

Forkwell, Findy, LAPRAS, 転職ドラフトなどの転職媒体や知人からのリファラルで転職活動をした。媒体内での企業検索は行わずスカウトを主に利用したが、スカウト起点だと最低限のフィルタリングは通っている（と思いたい）のでミスマッチが多少防げるかなと思っている。スカウトが少なければ検索も利用しようと思ったが、これらの媒体で220社以上からスカウトが来ており、検討する会社としては十分だったためスカウトのみの利用となった。

ちなみに、会社や事業の面白さ・ワクワク感を大事にしていたので、スカウトの文面に関してはパーソナライズされているかどうかはそこまで気にならなかった。もちろんパーソナライズしないと見てくれない層もいると思うしパーソナライズされたスカウトは第一印象が良いのでやった方が良いとは思う。

Forkwellの上級エンジニア特化のエージェントサービス

Forkwellに関しては上級エンジニア特化のエージェントサービスがあったためそちらも活用させていただいた。エージェントと書いてあるが、基本的には自分が応募先などのコントロールを行い、アドバイザーとして入ってもらうような形で利用している。転職のサポート（企業情報・ノウハウ共有）以外だとキャリアの壁打ちもやってもらい「キャリアの川下り型・山登り型」「入社後の適応グラフ（ハネムーン期など）」「テックリードの6系統」「年収分布の話」など自分を客観的に分析するきっかけになったし、利害関係が無くITエンジニアのキャリアの専門家に相談できるのはとても有意義な時間だった。対応いただいた赤川さんは以前から一方的に存じあげていて、実際面談してみるとキャリアや転職事情に関して詳しいだけではなくエンジニアリングマネジメントや事業責任者の経験もお持ちなのでそれらの視点も踏まえたアドバイスもいただけたのはとても良かった。

転職ドラフトと想定年収

他の転職媒体と違って、転職ドラフトは各指名に想定年収が提示される（そのまま採用に至った場合は9割保証される）ため、市場価値・条件面での目安になるのが良かった。というのも、3社目の待遇が高かったので、市場価値的に同額貰えることにイマイチ確信が持てず、転職により年収が下がることを懸念していたからである。

参加してみた結果、ある回で指名数トップ（〜60社）で1位指名が〜20社、最高提示年収も5位以内と非常に良い結果になり、現年収とそこまで乖離がないことが確認できた。ちなみに4年前も転職ドラフトに参加していて、その時も指名数トップだったが最高提示年収は〜25位程度で、想定年収の中央値も今回の方が300万ほど高い。4年前は提示年収をもっと上げていかないとなぁとぼんやり思っていたので、この結果には大変満足しているし、転職を決意する１要素となった。

余談: 過去の転職活動について

1社目 => 2社目の転職は受託開発会社から事業会社への転職だった。最初の転職だったのもあり、ビジネスドメイン問わず事業会社を幅広く受けていて、Green、Wantedlyなどの転職媒体やエージェントを使って転職活動をしていた。エージェントは会社を幅広く紹介してくれたり転職のノウハウを教えてくれるため、最初の転職としては良い選択だったと思う。ただ、良くも悪くもエージェントのペースになることもあるのでそこのハンドリングは必要とも思った。そのため今回は、前述のForkwellのエージェントサービスでは転職サポートという立ち位置で入っていただき、案件紹介や転職活動の壁打ちなどをメインに活用させていただいた形となる。

2社目 => 3社目の転職はエージェントは特に利用せずスカウト起点でカジュアル面談・面接を経て採用に至った。結局1社しか選考に進まなかったので面接の場数を踏んで練習することができなかった。また、1社だけだと給与交渉がしづらく、入社時の待遇は2社目より下がってしまった。そのため後述の通り、今回は複数の会社の選考を受けることを意識していた。

カジュアル面談

Forkwell の赤川さんからは、カジュアル面談を20社ほど受けてみてはと言われていたが（この数は相手の状況や考え方によるそう）、結果として2ヶ月で40社ほど受けた（平日1日1社ペース）。これは、それぐらいの数の会社の話を聞いておけば納得感ある転職活動になるかと思ったのと、面談の場数を踏むことで自身の気持ちの整理やべシャリの練習になると思ったためである。特にドメインを絞ることなく幅広く聞いていて、面白そうな会社が多かったので結果的にそうなったとも言える。ちなみにこんなにカジュアル面談を受ける人はいないらしい。

カジュアル面談では現場エンジニア、マネージャー、人事、VPoE、CTOが対応するパターンなど色々と経験できた。会社や事業の内容など簡単に説明いただき、「組織的課題」「ビジネス的課題」「技術的課題」についてヒアリングしていた。会社の課題感などがわかると、「課題を解決するスキルセット的にマッチしているか」「課題を解決することでスキルを上げていけそうか」などよりキャリア的なイメージも湧きやすいためである。個人的にはVPoE、CTOレベルの方にご対応いただけると、よりリアルな組織的課題・技術的課題をヒアリングできたので良かった。逆に人事レベルだとこのあたりが全然聞けず、会社や事業を説明いただくだけで終わるのでやや厳しいイメージ。採用サイトや会社のテックブログがあると事前にインプットできる情報量が増えてカジュアル面談が充実するのでとても良かった。

ちなみに、技術スタックに依らず色々と会社を見てきたが、サーバーサイドの技術スタック的にはRubyを使っている会社が多く、次点でGo、その次がPHPという感じだった。PHPは比較的歴史が長いプロダクト、Rubyは直近5〜10年でリリースされたプロダクトやもともとRubyでの知見がある会社で採用されているイメージ。

面談候補日程に関しては手動（メッセージでのやりとり）やSpirなどのwebスケジューリングツールを使った方式の2パターンあるが、40社も受けるとスケジュール管理がめっちゃ大変なので後者のようなツールを使うパターンの方が圧倒的に楽だった。すべてリモートでのカジュアル面談だったが、ツールとしてはGoogle Meetが多く、次点でZoomという感じ。

面接

カジュアル面談を受けた中から絞り込んで最終的に4社の選考に進んだ。対面の面接だけではなく、アプリケーションを事前に構築するような技術課題やリファレンスチェック（back check）もあった。通常の面接よりも技術課題やリファレンスチェックの方が時間や調整面など精神的に大変だったかもしれない。一方でこれらの効果や意図も理解できるので、採用する側の視点で採用面接ムズいなぁと思った。

また、転職というのは会社とのマッチングなのだなぁというのは改めて思った。ソフトスキル・ハードスキルだけではなく会社のカルチャーや事業フェーズ、キャリア・条件面のすり合わせがあり、スキルの高いエンジニアであれば入れる会社も増えるということは無く、歳を重ねるにつれて本当に入りたい入れる会社というのは狭まっていくようにも思う。とはいえ、スキルを磨けば見えなかったものが見えるようになり、エンジニアリングをもっと楽しめるようになるし人生の幅も広がるような気もしているので、もっとスキルを磨いていきたい。

その他

このブログや会社のテックブログの記事のウケが良かった。特に会社のテックブログの方はドメインなど泥臭いところも色々書いていたので事前にどういうことをどういう考えでやってきたかを明確に伝えることができたのが良かった。プライベートのブログはかなりニッチな記事が多いんだけど反応してもらえるとめっちゃ嬉しいし、それをベースに面談・面接で雑談が弾んだりした。

また、Job Descriptionなどを見てて、ICやスタッフエンジニアなどプレイヤーとしてのロールが話題になりつつも、現状の日本においてはマネジメント層がモテる＝ニーズがあり給与が高い感じなんだなぁと思ったりした。EMも専門職だし向き不向きがあると思うのでEMになった方が良いとは思わず、社会的にはそんな感じだよなぁという単なる感想なのだが、そういったソフトスキルもちゃんとICとして磨いていかないとなぁと考えさせられた。

まとめ

今回の転職活動についてざっくばらんに書いてみた。エンジニア向けの転職媒体やサービスが増えて転職活動がしやすくなった気がする。特に会社以外で利害関係無くキャリアの壁打ちが手軽にできるのはとても体験が良かった。今回の転職活動でお世話になった皆様、本当にありがとうございました！

上述の通り、まだまだスキルも磨いていかないといけないなと思うことが多々あるのでこれからもやっていき！

3社目の退職と振り返り

Fri, 01 Mar 2024 07:30:00 +0900

4月15日付けで3社目である現職を退職するので心境などいろいろ書いてみる。（対面・口頭だとなかなか説明しきれないので…ｗ

現職に転職した理由

自分が魅力に感じるプロダクト、伸ばしていきたいプロダクトの開発をやってみたいというのが主なモチベーションで4年前に転職した。やりたいプロダクトに携わることで技術力も非技術力ももっと伸ばしていけるのではないか、日々の仕事の充実感も上がるのではないかと思ったからであり、そう思わせてくれるくらい魅力を感じたのが現職のプロダクトだった。

現職にジョインするにあたり、成果を早く出すことを強く意識した。というのも、前職（2社目）は技術力・仕事力は身についたものの、成果を出し切ることができなかったところがあり、不完全燃焼に終わってしまっていた。とにかく変に達観せずに手を動かして早く結果を出して信頼貯金を貯め、サービスをエンジニアリングでどんどんグロースさせていく、ということができれば最高だと思っていた。後述の通り、これは圧倒的に達成できた。

現職でなにをしていたか

一言でいうと、ICとしてプロダクトを進化させビジネスを加速させる仕事をやっていた。

新機能開発、機能改善、リファクタリング、CI/CD、開発環境整備など開発全般
新基盤のプロジェクトリード
プロダクト開発内製化のプロジェクトリード
テックブログ執筆、カンファレンス登壇、社内技術共有
採用

スタッフエンジニアでいうところのソルバー強め、テックリード・アーキテクト少々、という感じだろうか。現職ではテックリードというロールはないのだが、実質テックリードと言っても良いくらいの動きはしていたと思う。リポジトリに依っては創業CTOの次くらいコードを書いていた。仕事がとにかく楽しくて休日も仕事のことを考えていたし、週末は月曜日が待ち遠しかった。仕事に熱中した結果、市場価値は上がり、お金が転職のモチベーションにならない程度の待遇になり、職務経歴書に自信を持って書けるような仕事も数多くできた。

また、入社当時のエンジニアのキャリアラダー・評価は

エンジニア < マネージャー < 部長 < ...

といった評価・給与レンジになっていて、ICもマネージャーと同列の専門職として評価される土台を作れれば良いなと思って仕事をしていた。最終的に上記の評価レンジを大幅に崩すくらいの評価をいただき、社内の上級ICの職位（例えばシニア、スタッフ、プリンシパル）を作ることはできなかったものの、手を動かす上級ICの１例になれたのは良かった。

なぜ転職するのか

昨年育児休暇を取得したのだが、育休復帰後なぜかモチベーションが上がらない時期が続いていた。カジュアル面談してみたり整理した結果、仕事へのワクワク感がなくなってしまっていることがわかった。技術者であるがゆえ、Horizontal SaaSとして解消できる課題の幅や深さ、スケーラビリティがビジネス的にも技術的にも理解できてしまった結果、今やっている仕事がもたらす社会的な成果に対してワクワク感が減ってしまっていた。また、キャリア面においても、普段の仕事において持っている技術や経験の切り崩しが多くなっていたことや、手を動かす以外のエンジニアリングをもっとやっていきたいという意向もあった。これ自体は現職にいても実現できそうではあったものの、やはり上記のビジネスに対するワクワク感というところがネックになった。

ライフステージが変わったことにより興味領域の変化も感じている。育児をしていると様々な社会保障を受けることになり、国や自治体の施策などには今まで以上に目がいくようになった。また、親が後期高齢者であるため介護も自分事になってきている。

そういったわけでビジネスドメインとしてもっとワクワクできる仕事をやってみたいと思ったのがきっかけでカジュアル面談を受け始め、実際にワクワクできるビジネスドメイン、会社に出会って転職を決意した。

現職の環境はとても良く、トライできる仕事もまだまだありそうだったし、やり残したことはそれなりにある。信頼貯金の積み直し、環境の変化など、転職することによるリスクもあった。とはいえ、ビジネスへのモチベーションとそれによるキャリアなどのリターンを考え、今このタイミングで転職するのがベストだと判断した。

今後何をしたいのか

カジュアル面談をする中で社会課題を解決するようなビジネスにとてもワクワクした。社会課題は国や自治体の施策だけでは解決できず、民間企業だからこそ継続的に熱意を持って取り組むことができ、社会をよりよくできるのではないかと思っている。自分が直面する環境を自分で良くできることも魅力に感じている。

また、キャリアとしては個人として成果を出す、ではなく組織としてのパフォーマンスを最大化するため成果を出して行きたいと思っている。正直個人の成果としては今まで十二分にパフォーマンスを発揮できたのではないかと思っている。それ自体はとても良いのだがもっと組織に目を向けて中長期的に組織のパフォーマンスを最大化するようなことをやっていくことが上級ICとしても必要なんじゃないかと思っている。もちろん個人としてのパフォーマンスを期待されることもあるし、発揮する場面、発揮したほうが良い場面もたくさんがあると思うが、「組織として」「中長期的に」成長していくという軸を念頭に置いて、よりレバレッジの高い仕事をやっていきたいと思っている。

次の会社は社会的なインパクトの大きさを考えてもワクワクするし、組織視点での行動がより求められる事業環境なのでとてもワクワクしている。

余談

これまでの会社やモチベーションを振り返ってみると

1社目はなんとなくITおもしろそう、凄そうくらいの感じで入社して
2社目は技術をもっとやっていきたいなと思って入社して
3社目はプロダクトが好きでもっとグロースさせていきたいなと思って入社して
4社目はビジネス・業界をもっと良くしていきたいなと思って入社する。

どの会社に居たときも全力で仕事をしてきたからこそ、こういった感情やモチベーションの変化があり、結果として視座が高くなっているような気がしていて面白い。

最後に

現職はとても良い会社だったし、良い会社だったから４年も働けたし、成果を出して市場価値も上げれた。そしてこれからもっと良くなる会社であることは間違いない。それくらい良い人が集まり、居心地が良く、それでいて改善力が高い組織だった。

このタイミングで転職したことが正解だったと言えるくらい次の会社でも成果を残し、成長できるよう頑張っていきたい。

2024

Mon, 01 Jan 2024 00:00:00 +0900

2023年の振り返り

Sat, 30 Dec 2023 23:30:00 +0900

今年もええ感じに振り返っていくよ！

新規プロダクト Yappli CRM の内製化とグロース

今年はYappli CRMという顧客管理サービスにフルコミットした１年だった。 Yappli CRMは当初外注して作ってもらっていたサービスで、よりサービスを成長させていくべく内製化が今年始まり、その内製化及びサービスグロースのプロジェクトのリードエンジニアを私が担当した。

やったことは↓このあたりに書いてある

大変だったが、それ以上にめちゃくちゃ楽しくて、ここ数年で一番楽しかったんじゃないかというくらい。 4月に子供が生まれて4〜7月は育休を取ったので、そこでリードエンジニアは別の人にスイッチした。育休明けの8月からも同サービスを担当していて、メンバーとして新機能開発・不具合修正・改善など色々やった。10月からはCRMの運用保守チームに入って、問い合わせ、調査、小規模〜中規模の改善案件などやった。具体的には、不要なRedshiftクラスタを停止して１つのクラスタに集約したり、Redshiftで運用すべきではない機能をMySQLに移行したり、40〜50以上あるtroccoの転送設定を１つのバッチに共通化、運用効率化したり、各種データに対してCSVで一括入稿できるようにしたり、パフォーマンス最適化したり。調べてみたら、今年のPR数が合計300くらいだった。コード書く以外の仕事・改善もめっちゃやったことを考えると結構成果出せたんじゃないかと思う。

7年前にSalesforceの導入・支援をやっていた自分が、CRMのSaaSを作ることになるのはとても感慨深かった。Salesforceはこういう機能があったな、こういう指向性のサービスだったな、Salesforceと違ってこうしたい、という感じで思いを馳せながら開発していたし、Salesforceの凄さみたいなものも改めて感じた。

子供爆誕

4月中旬に子供が生まれた。とにかく無事生まれてくれてよかった。妻にも大感謝。子供が毎日毎秒めちゃくちゃ可愛くてどうしようもない。

1ヶ月目の新生児期間は家事も含めて母乳以外のことはすべて自分がやる、という感じでやっていて、2ヶ月目以降は妻の体調も良くなってきたので料理は基本全部自分が作るがそれ以外の家事育児はちょくちょくやってもらう、という感じにシフトした。育休前は全然料理しなかったが、クラシルとクックドゥを駆使して1〜2週間ローテくらいの料理は作れる感じになった。

子供は今のところあまり手がかからず、育児初心者の我々にとっては非常に助かった。夜なんか寝かしつけせずとも電気を消せば勝手に寝てくれる。正直このあたりは個人差がかなりあるんだろうなぁと思う。

育休中は子が寝ている時間など細切れに暇な時間が発生したので合間に会社のSlackとかTwitter/Xとかはてぶを見ていた。途中からそれにも飽きて会社ブログとかも書いていた。

はてぶやSlackやtwitter飽きてきたので合間でブログ書き始めてる
— tzm_freedom (@tzm_freedom) May 11, 2023

育休は「自分がもし退職したらどんな感じになるか」を疑似体験できて、自分がいなくてもうまく回っている様子を見て色々と考えさせられた期間でもあった。

育休という長期休暇で良かったことの１つとして自分が会社辞めた後にどんな感じになるのか疑似体験できたこと、というのがある…w
自分がやらなくても良い、あるいはやった方が良い仕事というのがわかってくるし、任せることが如何に大事かというのも痛感する。
— tzm_freedom (@tzm_freedom) July 5, 2023

自身がいなくても価値をコンスタントに出し続けれるような技術的、非技術的改善はやっぱレバレッジ高いよなぁと社のSlack見て思ったりする。技術的アプローチだと、1Qで取り組んだ開発基盤やCI/CD環境、ドキュメンテーションとか。非技術だとプロジェクト化、組織変更とか仕組み化全般という感じ
— tzm_freedom (@tzm_freedom) May 24, 2023

俺は技術的アプローチは得意なのだが非技術はあまりやったことが無いなぁとか、技術的アプローチも質と量を上げていかないとなぁとか。これらは中長期的視点なんだが、一方で短期的に大量に改善していく仕組みも必要だなぁとか。
— tzm_freedom (@tzm_freedom) May 24, 2023

あとは、午前中見る番組がルーティン化したり

毎日、zip→朝ドラ→あさイチ→DayDay→ヒルナンデス、してる
— tzm_freedom (@tzm_freedom) May 12, 2023

ネットスーパーで時短したり

ネットスーパー、月額料金以外にも割高気味ではあるものの時間＝精神的余裕ができるので今のところかなり助かってる
— tzm_freedom (@tzm_freedom) June 6, 2023

金曜日はアンパンマン見たり

金曜日はアンパンマンの日です
— tzm_freedom (@tzm_freedom) May 12, 2023

最初は妻が外出できず、子も長時間外出できないので癒やしを求めてベランピングしようと試みたり

環境整ってきた pic.twitter.com/WdX3dq8uCw
— tzm_freedom (@tzm_freedom) May 9, 2023

骨伝導イヤホン買ってランニングしたり

骨伝導イヤホン買ってみたけどなかなか良い
— tzm_freedom (@tzm_freedom) June 5, 2023

近くのプールで泳いだり

抽象に依存しなくても良くない？

Sat, 15 Jul 2023 09:30:00 +0000

抽象に依存するとかインターフェースを使うとか、そういった話や現実の実装を見てきて、そのメリットもそれなりに理解しているものの、実はそんなに必要ないんじゃないかと思っていたりする。Clean Architectureっぽいコードや過剰に設計を意識してそうなコードを読むとインターフェースを多用していることが多い。抽象化に加えて多階層だったりするとより読みづらいし書きづらい。

抽象化することによる可読性と保守性の問題

実装を読むときに抽象型が引数だったりすると、IDEの定義ジャンプのときに抽象型の定義に飛んでしまったりする。IDEや設定によってはその抽象型を実装する具象型に飛ぶこともできるけど、抽象型の定義に飛ぶのか具象型の定義に飛ぶのかという選択が必要となる。読むだけではなく書くときもやることが増える。新しくメソッドを定義したりメソッドの引数を変更する場合は抽象型と具象型の両方で対応する必要がある。変更に強くなるはずの抽象化をすることで、変更に弱くなっている…？

ポリモーフィズムのようにビジネスロジック的に抽象型が必要な場合は、利用する具象型が一意に決まらないので抽象に依存する他ない。ただ、if文/switch文の方が逆に読みやすいケースもあるので、可読性や保守性を考えて抽象化を適用した方が良さそうではある。

将来的にビジネスロジック的に必要になるかもしれないから抽象化しているという言い分もありそうだが、そのときにリファクタリングすれば良いじゃん、そのためにテストを書いておけば良いじゃん、と思ったりする。「変更のためにコードを書き換える必要がない」ではなく「変更のためにコードを書き換えても安全」という方が現実的かなという感じ。

テストと抽象化

ビジネスロジックではなくテストだけのモチベーションで抽象化したい場合は、テストに必要な最低限のコードをモックできるよう抽象化すれば良い。ただ、基本的にモックはあまりしない方がよいと思っていて、DBなどCIで準備しやすいものは現物を使ってテストをした方がリグレッションテストとしても望ましい。テストの速度は当然遅くなり、肥大化すれば開発者体験を損なう可能性もあるが、本物のテストをするためには必要なコストとも思うし、肥大化したときは並列化など対応策がある。

ここで言っている抽象化すべき最低限のコードというのは、外部APIの呼び出しなどコントロールできないコンポーネントのことである。これらはローカル開発環境やCI環境で準備できないが、抽象化することでモックを使ってテストができるようになる。この場合も、むやみに抽象化すると認知負荷を上げる要因となるため、テスタビリティを意識して必要な要素だけ抽象化する方が良い。

余談: PHPはテストがしやすい

ただし、PHPだとその言語特性が故に抽象型を使わなくてもモックができてしまう。PHPUnitのモックや、streamWrapper を使った PHP-VCR など、動的にクラスを定義したりコードを書き換える黒魔術によりテストが困難なアプリケーションであっても後付けでテストできることが多い。つまり外部API呼び出しなど一般的には抽象化しないとテストができないものに関しても、PHPでは抽象化する必要無くテストができる。

逆に静的型付け言語の場合は抽象型を使わないとモックができない場合が多い。PHPの場合はそうであるだけの話で、それがPHPのメリットでもある。モックをする箇所は外部APIなど大抵I/Oの処理なので、PHPはI/Oがあるアプリケーションにおいてテストがしやすいということになる。Easyな思想でテストがしやすい、それでありながら型付けができる柔軟性の高い言語、PHP。

理想と現実

自分は現実主義なので、理想は理想で理解しようと試みつつ現実の課題を最大限解いていきたい。技術はそれ自体のメリットだけではなく学習コスト・認知負荷・サービスやチームの状況も考えて導入する必要がある。抽象化も当たり前のようにやる技術というよりは、このあたり考えて導入した方がよい技術なのではないかと思ったり思わなかったり

2023

Sun, 01 Jan 2023 00:00:00 +0900

2022年の振り返り

Thu, 29 Dec 2022 09:30:00 +0000

今年もええ感じに振り返っていくよ！

新機能開発プロジェクトのリードエンジニア

新機能開発のプロジェクトリードを今年の８月まで担当した。プロジェクト自体の担当期間は２年間、リードとしては昨年も合わせて１年間担当したことになる。初回リリースは１月で、昨年は新基盤の立ち上げフェーズ、今年はエンハンスするフェーズだった。

振り返ると、基盤改善と銘打つだけあり抽象度が高く要件定義に難航したプロジェクトだった。昨年は要件定義から実装まで結構タスクをこなしていたものの、実際のリリースは今年ということで昨年の年末年始はわりと精神的にやられていた。とはいえ、無事ランディングできたことはかなり自信にもなったし、社内外での評価も高く、プロジェクトメンバー的にもやったことが報われたのは本当に良かった。エンハンスもスケジュール的に大きな遅延なく、むしろ初回リリースよりもかなり複雑な機能追加の仕様に向き合ったことを考えると俺もメンバーも力を出し切った良いプロジェクトだったように思う。

全体的なスループットなどを考えて、自分はほぼ実装をやらず、各種調整・要件詳細決め・タスク割当て・設計・QA調整などに全振りした。プロジェクトとしては筋の良いアサインを行ったと思うのだが、自身が成果を出すのではなくチーム全体が成果を出せるような仕組みづくりや小石取りが主業務になるので、自身の成果を感じにくく、モチベーションとして維持しづらいというのは正直あったかもしれない。このあたりはアンラーニングしないといけない部分だとは思うもののまだ振り切れていない感じ。とはいえ、プロジェクトリードであっても課題解決の連続で、プロジェクトリードでしか学べないたくさんのことを経験できた。

特に様々なメンバーとコミュニケーションを取ることによる気づきがたくさんあった。例えば、その人の得意領域と業務がマッチしたときの成果の質とスピードや、自分には到底出来ない仕事の成果を目の当たりにし、人の得意不得意を活かすコミュニケーションは大事だなと思ったし、専門性の高いメンバーと一緒に仕事ができる楽しみも一層感じた。一方で、コミュニケーションの難しさも痛感しており、適切な言語化みたいなところももっと勉強しないといけないなと思った。

ちなみにこの新機能のプロジェクトリード自体は9月初旬で引き継ぎを行い、9月中旬からは後述のサーバーサイドの改善を行っていた。のだが、実は来年また違うサービスのプロジェクトリードになることが決まっていたりする。今回の役割はどちらかというとテックリードに近く、調整業というよりは実装で結果を出すことが求められる感じなのでめちゃくちゃ楽しみ。

改善業

入社当初から技術的な課題でずっと気になっているところがあり、プロジェクトの合間を縫ってちょいちょい改善していたのだが、重めの課題にあまり着手できていなかったのと、プロジェクトが一段落するちょうど良い節目だったので9月中旬から上記プロジェクトを外れて改善業を行った。

具体的には↓のタスクをだいたい数ヶ月〜半年くらいの期間で行った

EOLなPHPやフレームワーク・ライブラリをアップグレード
一部テーブルをSQLite3からMySQLに移行するプロジェクトの引き継ぎ＆完遂
主要アプリケーションでテストカバレッジを75%程度まで引き上げ（引き上げ前は50〜60%くらい）
不要コード削除（有識者に聞いたりログを見たりしてコードが半分くらいになった）
インデックスを貼ってない部分やTwigのキャッシュ設定やAPIレスポンスの調整を行って高速化
共通化・エラーハンドリングの強化・autoload化・単体テストができるようにするリファクタリング
symfony/pantherを使ったE2Eテストの導入
lintの導入・適用やPHPStanのレベル上げ
CircleCIのイメージを新しいものにしたり、カバレッジ測定をphpdbgに切り替えたり

改善業としてはだいたい最低限やりきったなという感じで、私が入社した３年前と比べると本当にだいぶ良くなったなと思っていたりする…ｗテストは無かったしlintや静的解析も無いしライブラリやミドルウェアもEOLだし不要コードもたくさんあったし、冗長なコードだらけな状態だったしWARNING, Noticeも出し放題だったのが今ではほとんど解消しているし、改善方法を社内共有会やSlackやPRで残せているので、少なくとも３年前よりは俺じゃなくてもトライできる環境になっているのではないかと思う。

これ以外だと、今まであまりメンバーが触ったことのないサービスに関する改善も積極的に首をつっこんで改善していった。結果として他のメンバーもそのサービスを改善できていたりするので、結構良いムーブだったんじゃないかなと思う。

また、プロジェクトリード業で実装に関われないフラストレーション解消のためたびたび話題に出ていたちょっと重そうな機能追加の実装にも関われた。というか「これやりましょうよ、俺実装やるんで」みたいな感じで声がけして一気に要件定義して実装・QA・リリースした案件で、これもムーブとしては良かったんじゃないかと思う。本当はこういう感じでメンバードリブン・エンジニアドリブンでどんどん良さそうな機能を立案したりあーでもないこーでもないと言って議論して進めていくのが良いと思うんだけど、こういう事例をたくさん作ってそういうムーブが生まれやすくするのも俺の責務かなとも思っていたりする。

PHPerKaigi, PHPConferenceの登壇

4月、10月に行われたPHPerKaigi、PHPConferenceのCfPを提出、ありがたいことに採択いただき登壇した。前述の通り、プロジェクトリード業が主だったので昨年と違ってPHP系の仕事ネタが無く、趣味の内容に振り切った。

DBGpのネタは結構前に書いたブログを焼き直しした内容で、派生してphp-srcを読んで、PHPConferenceにphp-srcネタで登壇するなど yak shaving な登壇ができたのは面白かった。なんやかんやPHPerKaigiもPHPConferenceも現職入って２回ずつ登壇していてるんだよなぁｗ

ブログ執筆

会社のテックブログは14本ほど書いた。昨年に比べるとプロジェクト系やテックブログのノウハウなど結構大きめなトピックで書くこともあり、社内での反響もそれなりにあって発信してよかったなと思った。

LiteFSコードリーディング：その２

Tue, 16 Aug 2022 10:00:00 +0000

LiteFS の仕組みについて読み解いてみました。今回はFUSEとノード間の同期処理周りを読んでみました。

ReplicaはPrimaryにHTTPで問い合わせを行い（ロングポーリング）、ユーザはFUSE経由でPrimaryのSQLite3ファイルにアクセスします。 DMLが発行されるとファイルの書き込みが走るのでdirtyPageとしてマーキングしておき、COMMITしたらdirtyPageの情報を使って差分のページ領域をまとめたLTXファイルをReplicaに送ります。 Replicaは返されたLTXファイルを使って差分のページ領域を更新します。

FUSEの処理

Filesystem.Mount() でFUSEを使ったマウントを行います。v0.1.0の時点では hanwen/go-fuse を使っていますが、masterの最新では bazil/fuse を使っています。

// Mount mounts the file system to the mount point.
func (fs *FileSystem) Mount() (err error) {
	// Create FUSE server and mount it.
	fs.server, err = fuse.NewServer(fs, fs.path, &fuse.MountOptions{
		Name: "litefs",
		Debug: fs.Debug,
		EnableLocks: true,
		SingleThreaded: true, // TODO: Remove; Release() is causing an unexpected race error
	})
	if err != nil {
		return err
	}

	go fs.server.Serve()

	return fs.server.WaitMount()
}

fuse.NewServerの第一引数でFUSEのハンドラーとして RawFileSystem のinterfaceをセットしています。 FUSEでマウントしたディレクトリ内のファイルを開くときは FileSystem.Open() が呼ばれ、ファイル読み込みのときは FileSystem.Read() といった感じでFileSystemの関数が呼ばれます。

SQLite3のファイルを開いたときは FileSystem.openDBFile() が呼ばれます。開かれるのは ${マウントディレクトリ}/{DB番号}/database のファイルになります。これが操作するSQLite3ファイルの実体になります。

func (fs *FileSystem) openDBFile(cancel <-chan struct{}, input *fuse.OpenIn, out *fuse.OpenOut) (code fuse.Status) {
	dbID, fileType, err := ParseInode(input.NodeId)
	if err != nil {
		log.Printf("fuse: open(): cannot parse inode: %d", input.NodeId)
		return fuse.ENOENT
	}

	db := fs.store.DB(dbID)
	if db == nil {
		return fuse.ENOENT
	}

	f, err := os.OpenFile(filepath.Join(db.Path(), FileTypeFilename(fileType)), int(input.Flags), os.FileMode(input.Mode))
	if err != nil {
		log.Printf("fuse: open(): cannot open file: %s", err)
		return toErrno(err)
	}

	fh := fs.NewFileHandle(db, fileType, f)
	out.Fh = fh.ID()
	out.OpenFlags = input.Flags

	return fuse.OK
}

SQLite3のファイルを読み込む場合は FileSystem.readDBFile() が呼ばれます。読み込み時には特に何も行わないため、Open()で開いたdatabaseファイルのファイルディスクリプタを使って読み込みを行います。

LiteFSコードリーディング：その１

Sun, 14 Aug 2022 19:00:00 +0000

LiteFS の仕組みについて読み解いてみました。今回は起動〜リードレプリカの部分をざっくり紹介します。 FUSE周りの仕組みに関しては別記事で紹介予定。

ちなみにLiteFSを試したときに使ったDockerfileなどはこちらに置いているので手軽に動かしたいときにご活用ください🙏

コードリーディング

全体としてはこういうシーケンスになっている（間違っていたらご指摘ください

Main.Run() がメインの処理なのでここから見ていきます。

initStore()
initHttpServer()
initConsul()
openStore()
initFileSystem()

の順に実行されます。

まず、 Main.initStore() でStoreのstructを初期化をします。

func (m *Main) initStore(ctx context.Context) error {
	mountDir, err := filepath.Abs(m.Config.MountDir)
	if err != nil {
		return fmt.Errorf("abs: %w", err)
	}
	dir, file := filepath.Split(mountDir)

	m.Store = litefs.NewStore(filepath.Join(dir, "."+file))
	m.Store.Client = http.NewClient()
	return nil
}

NewStoreの引数を見てもらうとわかるように、${マウントディレクトリの親ディレクトリ}/.${マウントのファイル名} にストアのパスが設定されます。例えば /tmp/hoge をマウントした場合は /tmp/.hoge にストアのパスが設定されます。これはFUSEのマウント先としては /tmp/hoge として利用し、SQLite3やLTXファイルなどの実体は /tmp/.hoge に置いて管理しているためです。

Main.initHttpServer()はノード間での通信を行うためのHTTPサーバーを初期化します。

func (m *Main) initHTTPServer(ctx context.Context) error {
	server := http.NewServer(m.Store, m.Config.HTTP.Addr)
	if err := server.Listen(); err != nil {
		return fmt.Errorf("cannot open http server: %w", err)
	}
	m.HTTPServer = server
	return nil
}

Main.initConsul() ではLeaserの構造体を初期化しています。LiteFSではPrimaryのノードを決定するためにConsulの client-side leader elections を利用しています。 PrimaryのノードはLeaserを使ってキーを一定期間リースし、定期的にTTLを更新（Renew）します。何らかでPrimaryのノードが死んでしまった場合はリース切れし、別のノードがPrimaryになります。

func (m *Main) initConsul(ctx context.Context) error {
	// TEMP: Allow non-localhost addresses.

	// Find advertise URL from function if this is a test.
	advertiseURL := m.Config.Consul.AdvertiseURL
	if m.AdvertiseURLFn != nil {
		advertiseURL = m.AdvertiseURLFn()
	}

	leaser := consul.NewLeaser(m.Config.Consul.URL, advertiseURL)

	leaser.Key = m.Config.Consul.Key
	if err := leaser.Open(); err != nil {
		return fmt.Errorf("cannot connect to consul: %w", err)
	}
	log.Printf("initializing consul: key=%s url=%s advertise-url=%s", m.Config.Consul.URL, m.Config.Consul.Key, advertiseURL)

	m.Leaser = leaser
	return nil
}

Main.openStore() はデータベースをオープンし、goroutineを使ってレプリケーションのモニタリングを行います。

[Laravel読書録]その２: $kernel->handle()

Sat, 28 May 2022 10:00:00 +0000

Laravelの $kernel->handle() は何をしているのか調べてみたメモ。 Laravelのバージョンは v9.8.1 です

$kernel は \App\Http\Kernel のインスタンスです。

handle() はこんな感じ。$requestは Illuminate\Http\Request のインスタンスが入る。

public function handle($request)
{
 try {
 $request->enableHttpMethodParameterOverride();

 $response = $this->sendRequestThroughRouter($request);
 } catch (Throwable $e) {
 $this->reportException($e);

 $response = $this->renderException($request, $e);
 }

 $this->app['events']->dispatch(
 new RequestHandled($request, $response)
 );

 return $response;
}

sendRequestThroughRouter() では $request をapp（Illuminate\Foundation\Application）のinstancesにセット、 bootstrap() を呼び出しPipelineを使ってRouterを呼び出す。

protected function sendRequestThroughRouter($request)
{
 $this->app->instance('request', $request);

 Facade::clearResolvedInstance('request');

 $this->bootstrap();

 return (new Pipeline($this->app))
 ->send($request)
 ->through($this->app->shouldSkipMiddleware() ? [] : $this->middleware)
 ->then($this->dispatchToRouter());
}

bootstrap() は bootstrappers() を引数に app->bootstrapWith() を呼び出す。

public function bootstrap()
{
 if (! $this->app->hasBeenBootstrapped()) {
 $this->app->bootstrapWith($this->bootstrappers());
 }
}

bootstrapWith() はbootstrappersをmakeでインスタンス化して bootstrap() を呼び出す。

public function bootstrapWith(array $bootstrappers)
{
 $this->hasBeenBootstrapped = true;

 foreach ($bootstrappers as $bootstrapper) {
 $this['events']->dispatch('bootstrapping: '.$bootstrapper, [$this]);

 $this->make($bootstrapper)->bootstrap($this);

 $this['events']->dispatch('bootstrapped: '.$bootstrapper, [$this]);
 }
}

https://github.com/laravel/framework/blob/v9.8.1/src/Illuminate/Foundation/Application.php#L239

[Laravel読書録]その１: $app->make()

Mon, 23 May 2022 10:00:00 +0000

Laravelの $app->make() は何をしているのか調べてみたメモ。バージョンは v9.8.1 です。

$app は Illuminate\Foundation\Application のインスタンス。

Illuminate\Foundation\Application のコンストラクタの処理

コンストラクタではbasePathなどを設定しつつデフォルトのbindings, providers, aliasの登録をしている。

public function __construct($basePath = null)
{
 if ($basePath) {
 $this->setBasePath($basePath);
 }

 $this->registerBaseBindings();
 $this->registerBaseServiceProviders();
 $this->registerCoreContainerAliases();
}

https://github.com/laravel/framework/blob/v9.8.1/src/Illuminate/Foundation/Application.php#L172-L181

registerBaseBindings() はこんな感じな処理になっている。 static::setInstance() はシングルトンとしてApplicationを登録。

protected function registerBaseBindings()
{
 static::setInstance($this);

 $this->instance('app', $this);

 $this->instance(Container::class, $this);
 $this->singleton(Mix::class);

 $this->singleton(PackageManifest::class, function () {
 return new PackageManifest(
 new Filesystem, $this->basePath(), $this->getCachedPackagesPath()
 );
 });
}

https://github.com/laravel/framework/blob/v9.8.1/src/Illuminate/Foundation/Application.php#L198-L212

instance() はこんな感じで $this->instances にセットしている

public function instance($abstract, $instance)
{
 $this->removeAbstractAlias($abstract);

 $isBound = $this->bound($abstract);

 unset($this->aliases[$abstract]);

 // We'll check to determine if this type has been bound before, and if it has
 // we will fire the rebound callbacks registered with the container and it
 // can be updated with consuming classes that have gotten resolved here.
 $this->instances[$abstract] = $instance;

 if ($isBound) {
 $this->rebound($abstract);
 }

 return $instance;
}

https://github.com/laravel/framework/blob/v9.8.1/src/Illuminate/Container/Container.php#L468-L486

[php-src読書録]その１９: opcacheの最適化処理

Tue, 03 May 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１８

今日はopcacheによる最適化機構。理解しやすかったpass1,3,10あたりから。

最適化は zend_optimize() で行われている
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/Optimizer/zend_optimizer.c#L889:L889

pass 1 (Simple local optimizations)

zend_optimizer_pass1() で最適化が行われる。コメントの通り以下の最適化を行う。

/* pass 1 (Simple local optimizations)
 * - persistent constant substitution (true, false, null, etc)
 * - constant casting (ADD expects numbers, CONCAT strings, etc)
 * - constant expression evaluation
 * - optimize constant conditional JMPs
 * - pre-evaluate constant function calls
 * - eliminate FETCH $GLOBALS followed by FETCH_DIM/UNSET_DIM/ISSET_ISEMPTY_DIM
 */

あらかじめstringにcastする（constant casting (ADD expects numbers, CONCAT strings, etc)
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/Optimizer/pass1.c#L48-L63
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/Optimizer/pass1.c#L106-L111

[php-src読書録]その１８: opcacheのファイルキャッシュ

Fri, 29 Apr 2022 00:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１８

今日はopcacheのファイルキャッシュ

キャッシュをファイルに保存

cache_script_in_shared_memory() で zend_file_cache_script_store() が呼ばれる
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L1650:L1650

zend_file_cache_script_store() で zend_file_cache_get_bin_file_path() が呼ばれキャッシュファイルのパスを生成する

/tmp/095a04392b125a7d278d14ce75956467/root/php-src-php-8.1.4/1.php.bin

こんな感じで opcache.file_cache にファイルの絶対パスを追加したファイルパスになる
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_file_cache.c#L990:L990

そのファイルパスのディレクトリを再帰的に作成する
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_file_cache.c#L992:L992

そのファイルパスで zend_file_cache_open() でファイルを開き、writev() でキャッシュを書き込んでいる
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_file_cache.c#L998:L998
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_file_cache.c#L1052:L1052

キャッシュを書き込む前に構造体をごにょる必要がある。なんでかというと構造体に含まれるポインタはその実行環境におけるポインタになるので、次にロードされるときには不正なポインタになってしまう。各ポインタをメモリの先頭アドレスからの差分にして保存、利用するときはメモリの先頭アドレスにその差分を足せば正しいポインタになるので、ポインタの変換をキャッシュの保存・取得時に行っている。

ファイルキャッシュに保存する際の変換は zend_file_cache_serialize で行われる。
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_file_cache.c#L908-L913

このあたりでファイルキャッシュに保存する構造体に値をセットしている
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_file_cache.c#L896-L905

その後、 SERIALIZE_STR や zend_file_cache_serialize_hash などでポインタ変換を行う。 SERIALIZE_STR はこんな感じで (ptr) = (void*)((char*)(ptr) - (char*)script->mem); によって先頭アドレスからの差分に変換している。

#define SERIALIZE_STR(ptr) do { \
		if (ptr) { \
			if (IS_ACCEL_INTERNED(ptr)) { \
				(ptr) = zend_file_cache_serialize_interned((zend_string*)(ptr), info); \
			} else { \
				ZEND_ASSERT(IS_UNSERIALIZED(ptr)); \
				/* script->corrupted shows if the script in SHM or not */ \
				if (EXPECTED(script->corrupted)) { \
					GC_ADD_FLAGS(ptr, IS_STR_INTERNED); \
					GC_DEL_FLAGS(ptr, IS_STR_PERMANENT); \
				} \
				(ptr) = (void*)((char*)(ptr) - (char*)script->mem); \
			} \
		} \
	} while (0)

キャッシュをファイルから取得

read() でファイルからキャッシュを読み取り
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_file_cache.c#L1715:L1715
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_file_cache.c#L1763:L1763

[php-src読書録]その１７: opcacheの保存と取得

Wed, 27 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１７

opcache続き。コードを読む前にnikic大先生の記事を読むのが良さそう
https://www.npopov.com/2021/10/13/How-opcache-works.html

zend_なんちゃらの差し替え

main()
=> php_cli_startup()
=> php_module_startup()
=> zend_startup_extensions()
=> zend_llist_apply_with_del()
=> zend_extension_startup()
=> opcache.so!accel_startup()

という感じで accel_startup() が呼ばれる

accel_startup() では zend_post_startup_cb に accel_post_startup() をセットしている。
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L3156:L3156

zend_post_startup_cb は以下の経路で呼ばれる

main()
=> php_cli_startup()
=> php_module_startup()
=> zend_post_startup()
=> opcache.so!accel_post_startup()

https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend.c#L1045

zend_compile_file zend_stream_open_function zend_resolve_path にそれぞれ、
persistent_compile_file persistent_stream_open_function persistent_zend_resolve_path を設定
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L3279-L3291

キャッシュの取得と保存

zend_compile_file 経由で persistent_compile_file() が呼ばれキャッシュを検索する。
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L2000-L2007

ZCSG(hash) というのがファイル名から生成したキー => キャッシュの実態（oparrayとかclassやfunction tableなど）のハッシュテーブルになる（後述）

ファイルの場合はこの辺で判定
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L1961-L1965
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L2136-L2138

キャッシュがない場合 opcache_compile_file() を呼び出す
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L2160:L2160

opcache_compile_file() は accelerator_orig_compile_file() を呼び出し、元のzend_compile_fileでop_arrayを生成する。
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L1789:L1789

その後 cache_script_in_shared_memory() でキャッシュする
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L2169:L2169

cache_script_in_shared_memory() は zend_accel_script_persist() を呼び出す
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/ZendAccelerator.c#L1600:L1600

zend_accel_script_persist() では共有メモリ内にopcacheを生成している。例えば zend_shared_memdup_put() などで共有メモリ内に領域を確保する。
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_persist.c#L525:L525
https://github.com/php/php-src/blob/PHP-8.1.4/ext/opcache/zend_shared_alloc.c#L391-L393

[php-src読書録]その１６: gdbserver

Sun, 24 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１６

今日からopcache

の前にmacOSでsoのgdbデバッグがうまくいかなかったので備忘録。

発生していた事象

–enable-debugでビルドしても opcache.so がうまく解釈されずこんな感じに ?? となってしまってブレークポイントも効かない状態に。

(gdb) b compile_file
Breakpoint 2 at 0x100458c32: file Zend/zend_language_scanner.l, line 642.
(gdb) r
Starting program: sapi/cli/php -dopcache.enable_cli=1 -dopcache.opt_debug_level=0x10000 -dopcache.jit=disable -dzend_extension=/path/to/modules/opcache.so 1.php
[New Thread 0x260b of process 93229]
[New Thread 0x2303 of process 93229]
warning: unhandled dyld version (17)

Thread 2 hit Breakpoint 2, compile_file (file_handle=0x7ff7bfefe228, type=8) at Zend/zend_language_scanner.l:642
642 zend_op_array *op_array = NULL;
(gdb) bt
#0 compile_file (file_handle=0x7ff7bfefe228, type=8) at Zend/zend_language_scanner.l:642
#1 0x0000000100217e69 in phar_compile_file (file_handle=0x7ff7bfefe228, type=8) at ext/phar/phar.c:3351
#2 0x0000000102da18e4 in ?? ()
#3 0x0000000264e8ae9a in ?? ()
#4 0x0100000102a5b5a0 in ?? ()
#5 0x0000000100ecd508 in ?? ()
#6 0x0000000000000000 in ?? ()

本当はこうなってほしい

[php-src読書録]その１５: interfaceとtrait

Thu, 21 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１５

今日はinterfaceとtrait

interface

<?php

interface Base
{
 public function hoge();
}

class Hoge implements Base
{
 public function hoge()
 {
 }
}

opcode

$_main:
; (lines=2, args=0, vars=0, tmps=0)
; (before optimizer)
; /path/to/15.php:1-14
; return [] RANGE[0..0]
0000 DECLARE_CLASS string("hoge")
0001 RETURN int(1)

Base::hoge:
; (lines=1, args=0, vars=0, tmps=0)
; (before optimizer)
; /path/to/15.php:5-5
; return [] RANGE[0..0]
0000 RETURN null

Hoge::hoge:
; (lines=1, args=0, vars=0, tmps=0)
; (before optimizer)
; /path/to/15.php:10-12
; return [] RANGE[0..0]
0000 RETURN null

implementsした場合は DECLARE_CLASS opcodeが出力されているのがポイント。前回はuseとimplementsがないパターンの継承パターンだったが、useとimplementsがある場合はフローがちょっと変わってくる。

[php-src読書録]その１４: 継承

Fri, 15 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１４

引き続きclass。今日は継承

<?php

class Base
{
 public function call()
 {
 echo 123;
 }
}

class Hoge extends Base
{
}

(new Hoge)->call();

opcode

$_main:
 ; (lines=5, args=0, vars=0, tmps=3)
 ; (before optimizer)
 ; /path/to/14.php:1-18
 ; return [] RANGE[0..0]
0000 V0 = NEW 0 string("Hoge")
0001 DO_FCALL
0002 INIT_METHOD_CALL 0 V0 string("call")
0003 DO_FCALL
0004 RETURN int(1)
LIVE RANGES:
 0: 0001 - 0002 (new)

Base::call:
 ; (lines=2, args=0, vars=0, tmps=0)
 ; (before optimizer)
 ; /path/to/14.php:7-10
 ; return [] RANGE[0..0]
0000 ECHO int(123)
0001 RETURN null

extendsが定義されていると、 ce->parent_name にスーパークラスの名前がセットされる。
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L7721-L7724

[php-src読書録]その１３: プロパティのデフォルト値, static method

Wed, 13 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１３

引き続きclass。今日はプロパティのデフォルト値, static method

<?php

class Hoge
{
 public $hoge = 1;

 public static function call() {
 echo 123;
 }
}
echo (new Hoge)->hoge;
echo Hoge::call();

opcode

$_main:
 ; (lines=8, args=0, vars=0, tmps=4)
 ; (before optimizer)
 ; /path/to/13.php:1-14
 ; return [] RANGE[0..0]
0000 V0 = NEW 0 string("Hoge")
0001 DO_FCALL
0002 T2 = FETCH_OBJ_R V0 string("hoge")
0003 ECHO T2
0004 INIT_STATIC_METHOD_CALL 0 string("Hoge") string("call")
0005 V3 = DO_UCALL
0006 ECHO V3
0007 RETURN int(1)
LIVE RANGES:
 0: 0001 - 0002 (new)

Hoge::call:
 ; (lines=2, args=0, vars=0, tmps=0)
 ; (before optimizer)
 ; /path/to/13.php:7-9
 ; return [] RANGE[0..0]
0000 ECHO int(123)
0001 RETURN null

プロパティのデフォルト値

zend_compile_prop_decl() は zend_const_expr_to_zval() を呼び出す
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L7352:L7352

[php-src読書録]その１２: method呼び出し, private, protected

Tue, 12 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１２

classの続き。method呼び出し, private, protected

<?php

class Hoge
{
 private $fuga;

 public function call($foo)
 {
 echo $foo;
 }
}

$hoge = new Hoge();
$hoge->call(111);
$hoge->fuga;

opcode

$_main:
 ; (lines=9, args=0, vars=1, tmps=5)
 ; (before optimizer)
 ; /path/to/12.php:1-16
 ; return [] RANGE[0..0]
0000 V1 = NEW 0 string("Hoge")
0001 DO_FCALL
0002 ASSIGN CV0($hoge) V1
0003 INIT_METHOD_CALL 1 CV0($hoge) string("call")
0004 SEND_VAL_EX int(111) 1
0005 DO_FCALL
0006 T5 = FETCH_OBJ_R CV0($hoge) string("fuga")
0007 FREE T5
0008 RETURN int(1)
LIVE RANGES:
 1: 0001 - 0002 (new)

Hoge::call:
 ; (lines=3, args=1, vars=1, tmps=0)
 ; (before optimizer)
 ; /path/to/12.php:7-10
 ; return [] RANGE[0..0]
0000 CV0($foo) = RECV 1
0001 ECHO CV0($foo)
0002 RETURN null

INIT_METHOD_CALL FETCH_OBJ_R あたり

[php-src読書録]その１１: classとコンストラクタ

Mon, 11 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１１

今回はいよいよ（？）class。

コンストラクタと初期化部分から

<?php

class Hoge
{
 public $fuga;

 public function __construct($fuga)
 {
 $this->fuga = $fuga;
 }
}

new Hoge(111);

opcode

$_main:
 ; (lines=5, args=0, vars=1, tmps=3)
 ; (before optimizer)
 ; /path/to/11.php:1-20
 ; return [] RANGE[0..0]
0000 V1 = NEW 1 string("Hoge")
0001 SEND_VAL_EX int(111) 1
0002 DO_FCALL
0003 ASSIGN CV0($hoge) V1
0004 RETURN int(1)
LIVE RANGES:
 1: 0001 - 0003 (new)

Hoge::__construct:
 ; (lines=4, args=1, vars=1, tmps=1)
 ; (before optimizer)
 ; /path/to/11.php:7-10
 ; return [] RANGE[0..0]
0000 CV0($fuga) = RECV 1
0001 ASSIGN_OBJ THIS string("fuga")
0002 OP_DATA CV0($fuga)
0003 RETURN null

class定義は zend_compile_class_decl() でコンパイルされる
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L7646:L7646

[php-src読書録]その１０: if/else/switch

Sun, 10 Apr 2022 00:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その１０

今回はif/else/switch

まずはif/else

<?php

if (true) {
 echo 111;
} else {
 echo 222;
}

opcode

$_main:
 ; (lines=5, args=0, vars=0, tmps=0)
 ; (before optimizer)
 ; /path/to/10.php:1-8
 ; return [] RANGE[0..0]
0000 JMPZ bool(true) 0003
0001 ECHO int(111)
0002 JMP 0004
0003 ECHO int(222)
0004 RETURN int(1)

zend_compile_if() でコンパイルされる

条件のコンパイル
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5392:L5392

JMPZの設定。ジャンプ先は後で設定。
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5393:L5393

if文のいずれかの処理にマッチした場合はif文を抜ける必要があるのでそのJMPの設定。JMP先は最後に設定
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5397-L5399

i != list->children - 1 の条件は最後のelseifはジャンプしないので分岐している感じっぽい

JMPZで条件に合致しなかったときのJMP先を次のelseif, elseの開始位置に設定
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5400

elseの場合は条件なしで実行する
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5404

if文のいずれかの処理にマッチしたときのif分を抜けるためのジャンプ先をここで設定
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5408-L5413

opcode

JMPZ は ZEND_JMPZ_SPEC_CONST_HANDLER で処理される

val = RT_CONSTANT(opline, opline->op1);

if (Z_TYPE_INFO_P(val) == IS_TRUE) {
	ZEND_VM_NEXT_OPCODE();
} else if (EXPECTED(Z_TYPE_INFO_P(val) <= IS_TRUE)) {
	// ...
	ZEND_VM_JMP_EX(OP_JMP_ADDR(opline, opline->op2), 0);
}

SAVE_OPLINE();
op1_type = IS_CONST;
if (i_zend_is_true(val)) {
	opline++;
} else {
	opline = OP_JMP_ADDR(opline, opline->op2);
}
// ...
ZEND_VM_JMP(opline);

Z_TYPE_INFO_P(val) == IS_TRUE だったり、 i_zend_is_true(val) がtrueの場合は次の処理に以降し、そうでない場合は OP_JMP_ADDR(opline, opline->op2) によって次の分岐部分（elseif か else）にジャンプします。

[php-src読書録]その９: whileとforeach

Sat, 09 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その９

今回はwhileとforeach

while

<?php

$i = 0;
while($i < 1) {
 echo 123;
 $i++;
}

opcode

$_main:
 ; (lines=7, args=0, vars=1, tmps=3)
 ; (before optimizer)
 ; /path/to/9.php:1-8
 ; return [] RANGE[0..0]
0000 ASSIGN CV0($i) int(0)
0001 JMP 0004
0002 ECHO int(123)
0003 PRE_INC CV0($i)
0004 T3 = IS_SMALLER CV0($i) int(1)
0005 JMPNZ T3 0002
0006 RETURN int(1)

見るとfor文とほぼ同じで、for文はinit/loopを書く場所が確保されているだけで本質的にはwhileと変わらないことがわかる。

JMPを生成
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5187:L5187

statementを生成
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5192

条件分岐前にJMP先を設定
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5195

条件判定とJMPを生成
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5196-L5198

foreach

foreachのスクリプト例

<?php

foreach([1, 2] as $a) {
 echo $a;
}

opcode

$_main:
 ; (lines=6, args=0, vars=1, tmps=1)
 ; (before optimizer)
 ; /path/to/9_1.php:1-6
 ; return [] RANGE[0..0]
0000 V1 = FE_RESET_R array(...) 0004
0001 FE_FETCH_R V1 CV0($a) 0004
0002 ECHO CV0($a)
0003 JMP 0001
0004 FE_FREE V1
0005 RETURN int(1)
LIVE RANGES:
 1: 0001 - 0004 (loop)

FE_RESET_R FE_FETCH_R FE_FREE あたりが新出なのでこのあたりを見ていく

Xdebugコードリーディング

Sat, 09 Apr 2022 02:00:00 +0000

PHPerKaigi 2022でXdebugのデバッガの話をするのですが、その調べ物ついでにXdebugのコードリーディングをしたのでその備忘録。

ちなみに発表資料はこちら

Xdebugのバージョンは3.1.3です。

Zend拡張の登録

xdebug_zend_startup() が初期設定です。xdebug_zend_startupは zend_startup_module(&xdebug_module_entry) を呼び出しています。

ZEND_DLEXPORT zend_extension zend_extension_entry = {
	(char*) XDEBUG_NAME,
	(char*) XDEBUG_VERSION,
	(char*) XDEBUG_AUTHOR,
	(char*) XDEBUG_URL_FAQ,
	(char*) XDEBUG_COPYRIGHT_SHORT,
	xdebug_zend_startup,
	xdebug_zend_shutdown,
	NULL, /* activate_func_t */
	NULL, /* deactivate_func_t */
	NULL, /* message_handler_func_t */
	NULL, /* op_array_handler_func_t */
	xdebug_statement_call, /* statement_handler_func_t */
	NULL, /* fcall_begin_handler_func_t */
	NULL, /* fcall_end_handler_func_t */
	xdebug_init_oparray, /* op_array_ctor_func_t */
	NULL, /* op_array_dtor_func_t */
	STANDARD_ZEND_EXTENSION_PROPERTIES
};

https://github.com/xdebug/xdebug/blob/3.1.3/xdebug.c#L806-L824

[php-src読書録]その８: forループ

Fri, 08 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その８

今日はforループ

<?php

for ($i = 0; $i < 2; $i++) {
 echo $i;
}

opcodes

$_main:
 ; (lines=7, args=0, vars=1, tmps=3)
 ; (before optimizer)
 ; /path/to/8.php:1-6
 ; return [] RANGE[0..0]
0000 ASSIGN CV0($i) int(0)
0001 JMP 0004
0002 ECHO CV0($i)
0003 PRE_INC CV0($i)
0004 T3 = IS_SMALLER CV0($i) int(2)
0005 JMPNZ T3 0002
0006 RETURN int(1)

AST

zend_compile_for() でforがコンパイルされる。

zend_compile_expr_list() で $i = 0; の部分がコンパイルされる
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5258:L5258

zend_emit_jump() でJMPのopcodeが生成される。ジャンプ先は後で設定する。
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5261
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L2138-L2144

opnum_jmpはopcodesのindex

zend_compile_stmt() でループ内のstmtのコンパイル
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5266

zend_compile_expr_list() でループの加算処理 $i++ をコンパイル
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5269

zend_update_jump_target_to_next() で最初のJMPオペコード opnum_jmp のジャンプ先を設定している
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L5272
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L2204

[php-src読書録]その７: ハッシュ

Thu, 07 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その７

今回はハッシュ

<?php

$tmp = ['hoge' => true];
$tmp['hoge'];
$tmp['fuga'] = false;

opcode

$_main:
 ; (lines=6, args=0, vars=1, tmps=3)
 ; (before optimizer)
 ; /path/to/7.php:1-6
 ; return [] RANGE[0..0]
0000 ASSIGN CV0($tmp) array(...)
0001 T2 = FETCH_DIM_R CV0($tmp) string("hoge")
0002 FREE T2
0003 ASSIGN_DIM CV0($tmp) string("fuga")
0004 OP_DATA bool(false)
0005 RETURN int(1)

FETCH_DIM_R, ASSIGN_DIM, OP_DATAなど基本的にはarrayと同じopcodeを使っている。

zend_compile_array() => zend_try_ct_eval_array() 経由で zend_symtable_update() を呼び出す
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L8533:L8533

zend_symtable_update() は zend_hash_update() を呼び出す
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_hash.h#L464:L464

_zend_hash_add_or_update_i() を呼び出される zend_stringからハッシュキーを算出。key.h にセットされる
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_hash.c#L736:L736

初期化時に zend_hash_real_init_mixed() が呼ばれる
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_hash.c#L741:L741

emalloc() でハッシュテーブルの領域が確保される
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_hash.c#L172

以下のバケット配列のサイズとハッシュテーブルのサイズを足した領域が確保される

バケットのサイズ: (size_t)(8) * sizeof(Bucket)
ハッシュのサイズ: ((size_t)(uint32_t)-(int32_t)((uint32_t)(-16))) * sizeof(uint32_t)

一番最初はデータの領域8要素分、ハッシュの領域16要素分の領域が確保される。

[php-src読書録]その６: array

Tue, 05 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その６

今回はarray

定数配列

<?php

$i = [1, 2];

以下がopcodeで、arrayがそのままアサインされることになる

$_main:
; (lines=2, args=0, vars=1, tmps=1)
; (before optimizer)
; /path/to/6.php:1-4
; return [] RANGE[0..0]
0000 ASSIGN CV0($i) array(...)
0001 RETURN int(1)

arrayは zend_compile_array() でコンパイルされる。定数配列の場合、 zend_compile_array() 内の zend_try_ct_eval_array() でarrayのzvalをコンパイルしている
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L9334

以下で全要素が定数であるかの確認
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L8454-L8483

array_init_size() でarrayを初期化
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L8494:L8494

マクロなどを全部展開するとこんな感じなコードになり、ハッシュテーブルをinitしてzvalにセットしている。

HashTable *ht = emalloc(sizeof(HashTable));
_zend_hash_init_int(ht, list->children, ZVAL_PTR_DTOR, 0);

zend_array *__arr = ht;
zval *__z = result;
__z.value.arr = __arr;
__z.u1.type_info = IS_ARRAY_EX;

各要素に対して zend_ast_get_zval() でzvalを取得する
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L8500

ここでresultにzvalをインサート
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L8559

ht->arData + h に配列としてデータを格納している
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_hash.c#L1077-L1084

変数入りの配列

<?php

$i = 1;
$j = [$i, 2];

opcodes

[php-src読書録]その５: function

Mon, 04 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その５

今回はfunction

<?php

function hoge($i) {}

hoge(123);

opcode

$_main:
 ; (lines=4, args=0, vars=0, tmps=1)
 ; (before optimizer)
 ; /path/to/5.php:1-6
 ; return [] RANGE[0..0]
0000 INIT_FCALL 1 96 string("hoge")
0001 SEND_VAL int(123) 1
0002 DO_UCALL
0003 RETURN int(1)

hoge:
 ; (lines=2, args=1, vars=1, tmps=0)
 ; (before optimizer)
 ; /path/to/5.php:3-3
 ; return [] RANGE[0..0]
0000 CV0($i) = RECV 1
0001 RETURN null

functionのコンパイル

zend_compile_top_stmt() から zend_compile_func_decl() が呼ばれる https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L9936

zend_compile_func_decl() では関数用のop_arrayを作成する
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L7172-L7292

zend_compile_func_decl() は zend_begin_func_decl() を呼び出し
https://github.com/php/php-src/blob/PHP-8.1.4/Zend/zend_compile.c#L7214:L7214

[php-src読書録]その４: ADDとTMPVAR

Sun, 03 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その４

デバッグの効率化

今までgdbを使っていたんだけどTUIモードというのがあるのを初めて知った。 gdb -tui で実行するとTUIモードでの実行になる。 gdb を実行してから C-x C-a でもOK。 tuiモードを使わないとステップ実行のたびに list を実行するなどしてソースコードを表示する必要があって大変…

そして、それよりもVSCodeのGUIデバッガの方がはるかに楽だった。 C/C++ のプラグインをインストールして launch.json をこんな感じで設定してデバッグ実行すればOK

{
 "version": "0.2.0",
 "configurations": [
 {
 "name": "(gdb) Launch",
 "type": "cppdbg",
 "request": "launch",
 "program": "${workspaceFolder}/sapi/cli/php",
 "args": ["test.php"],
 "stopAtEntry": true,
 "cwd": "${workspaceFolder}",
 "environment": [],
 "externalConsole": true,
 "MIMode": "gdb",
 "miDebuggerPath": "/usr/local/bin/gdb",
 "setupCommands": [
 {
 "description": "Enable pretty-printing for gdb",
 "text": "-enable-pretty-printing",
 "ignoreFailures": true
 }
 ]
 }
 ]
}

ADDとTMPVAR

今回はこちらのコードを追っていく

<?php

$i = 1;
$i = 1 + $i;

opcode

$_main:
 ; (lines=4, args=0, vars=1, tmps=3)
 ; (before optimizer)
 ; /path/to/4.php:1-5
 ; return [] RANGE[0..0]
0000 ASSIGN CV0($i) int(1)
0001 T2 = ADD int(1) CV0($i)
0002 ASSIGN CV0($i) T2
0003 RETURN int(1)

ASSIGNは前回説明済みなので割愛。

[php-src読書録]その３: 変数アサイン

Sat, 02 Apr 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その３

今回見ていくスクリプトはこちら

<?php

$i = "hoge";

変数アサイン

opcode

$_main:
; (lines=2, args=0, vars=1, tmps=1)
; (before optimizer)
; /path/to/3.php:1-4
; return [] RANGE[0..0]
0000 ASSIGN CV0($i) string("hoge")
0001 RETURN int(1)

gdbでhandlerをデバッグ

(gdb) p execute_data->opline->handler
$1 = (const void *) 0x100517cb0 <ZEND_ASSIGN_SPEC_CV_CONST_RETVAL_UNUSED_HANDLER>

ZEND_ASSIGN_SPEC_CV_CONST_RETVAL_UNUSED_HANDLERが呼び出される

static ZEND_OPCODE_HANDLER_RET ZEND_FASTCALL ZEND_ASSIGN_SPEC_CV_CONST_RETVAL_UNUSED_HANDLER(ZEND_OPCODE_HANDLER_ARGS)
{
	USE_OPLINE
	zval *value;
	zval *variable_ptr;

	SAVE_OPLINE();
	value = RT_CONSTANT(opline, opline->op2);
	variable_ptr = EX_VAR(opline->op1.var);

	value = zend_assign_to_variable(variable_ptr, value, IS_CONST, EX_USES_STRICT_TYPES());
	if (UNEXPECTED(0)) {
		ZVAL_COPY(EX_VAR(opline->result.var), value);
	}

	/* zend_assign_to_variable() always takes care of op2, never free it! */

	ZEND_VM_NEXT_OPCODE_CHECK_EXCEPTION();
}

RT_CONSTANTは定数のzvalを取得している。後述。

[php-src読書録]その２: echo

Thu, 31 Mar 2022 13:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。その２

opcodeの確認

OPcacheを使う方法

$ sapi/cli/php -dopcache.enable_cli=1 \
 -dopcache.opt_debug_level=0x10000 \
 -dzend_extension=$(pwd)/modules/opcache.so \
 hoge.php

$_main:
; (lines=2, args=0, vars=0, tmps=0)
; (before optimizer)
; /path/to/hoge.php:1-4
; return [] RANGE[0..0]
0000 ECHO int(123)
0001 RETURN int(1)

phpdbgを使う方法

$ ./sapi/phpdbg/phpdbg '-p*' hoge.php PHP-8.1.4 ⬆ ✭ ✱ ◼

$_main:
; (lines=2, args=0, vars=0, tmps=0)
; /path/to/hoge.php:1-4
L0003 0000 ECHO int(123)
L0004 0001 RETURN int(1)
[Script ended normally]

ECHOのハンドラーを見てみる

今回デバッグするスクリプト

<?php

echo "hoge";

opcodeはこんな感じ

$_main:
 ; (lines=2, args=0, vars=0, tmps=0)
 ; (before optimizer)
 ; /path/to/echo.php:1-4
 ; return [] RANGE[0..0]
0000 ECHO string("hoge")
0001 RETURN int(1)

ECHO opcodeを詳しく見てみる。

[php-src読書録]その１: CLI実行からスクリプト実行まで

Thu, 31 Mar 2022 10:00:00 +0000

php-srcのコードリーディングした内容をコツコツ残すテスト。

参考にした記事

PHP Internals Book
- PHPの内部のことが色々書いてある。
- PHPのビルド周りは、コード読みつつgdbで確認しつつ、という感じで理解を深めるために抑えておいたほうが良いかも。
PHP による hello world 入門
- SAPIを含めたPHPの実行フローについてまとまっている記事
- mod_phpのapacheのハンドラ周りも書いてあって流石すぎる…
PHP の関数実行とその計測（記事版）
- 関数実行の計測の切り口でZend Engineについて説明されている記事。コールスタック周りの理解にめっちゃ有用でした。超感謝。
PHP 7 Virtual Machine
- nikic大先生によるZend Engineの解説。
Implementing a Range Operator into PHP
- 実装して理解しようシリーズ（？）
- Lexer, Parser, ASTからopcodeへのコンパイル, VM実行と一通り処理を追えるのでコピペでも良いからやってみると良さそう。
- ちなみに実装したときの備忘録はこちら
本物のC
- C言語初心者には大変ありがたいサイト。マクロの定義や作法がわかってよき。

デバッグするにあたって

コード読むだけで理解しきるのは難しいのでgdbで実際の変数の中身を見ながらステップ実行していくと理解しやすい。デバッグするにはsrcから

./buildconf
./configure --enable-opcache --enable-debug
make

という感じでビルドしてgdbを実行すればOK

gdb --args sapi/cli/php test.php

Macの場合は、brewでgdbをインストールできる

brew install gdb

このままだと利用できないので以下の記事を参考にコード署名して利用する
OS XでGDBを使う（ためにコード署名をする）

sudo codesign -s gdb-cert /usr/local/bin/gdb

C言語を読むための知識

特に読むのに苦労しているのがマクロ…。

マクロはプリプロセッサで文字列置換をするものっぽい。

例えば

dim = RT_CONSTANT(opline, opline->op2);

は

dim = ((zval*)(((char*)(opline)) + (int32_t)(opline->op2).constant))

という感じで置換される。

[php-src勉強録]レンジオペレータの実装

Thu, 31 Mar 2022 09:00:00 +0000

レンジオペレータを追加してみよう的な記事を見てやってみたので備忘録。 https://phpinternals.net/articles/implementing_a_range_operator_into_php

わりとコピペなので深堀り（各関数が何やってるかとか）は別途やる予定。

PHPのビルド方法

だいたいこんな感じでビルドできる。

git clone git@github.com:php/php-src.git
cd php-src
./buildconf
./configure --with-iconv=/path/to/libiconv --enable-opcache
make -j4

このあとに、make installしても良いが面倒？な場合はsapi/cli/php が作られるのでそれを実行して動作確認するでも良さそう。拡張モジュールは modules/ にある。

設定変えたりブランチ変えて再ビルドしたいときはこんな感じで

make clean
./buildconf --force
./config.nice
make -j4

詳細はPHP Internals Book にめっちゃ書かれているので参照すると良さそう

レンジオペレータの追加

実装したものはこちら

php internalsの記事にあるように、以下を実装していけばOK

1. Lexerの修正

Zend/Zend/zend_language_scanner.l

2. Parserの修正

Zend/zend_ast.h
Zend/zend_language_parser.y

3. ASTからVMコードの出力

Zend/zend_compile.c

4. VMの変更（オペレータ追加）

Zend/zend_vm_def.h

zend_vm_def.hを修正して make すると以下のファイルが自動生成される。（PHPでCを生成しているの凄い。これも後で深堀りしたい

Zend/zend_vm_execute.h
Zend/zend_vm_handlers.h
Zend/zend_vm_opcodes.h
Zend/zend_vm_opcodes.c

Zend/zend_vm_gen.php を使って生成しているのでこのスクリプトを実行するのでもOK（試してない

echoの改変例

https://github.com/tzmfreedom/php-src/commit/71f330a36f6863af382df0d774c7803f95e4d489

とりあえずwrite()しまくる wei ステートメントを追加してみた。 echoのコピペ。 coreの変更なのでmod_phpでもCLIでも wei が使えるようになる。

2022

Sat, 01 Jan 2022 00:00:00 +0900

2021年の振り返り

Thu, 30 Dec 2021 09:30:00 +0000

仕事

採用へのチャレンジ

今年の新しいチャレンジとして採用業務をやっていた。最初はスカウト打つの手伝ってくれーという依頼から始まって、その延長でカジュアル面談や書類選考、採用面接などなど色々やった感じ。前職でも新卒・中途の採用面談をやっていたりしたんだが、この１年間は質・量ともに今までで一番採用にコミットした。

やったことはだいたいここに書いた。
サーバーサイドエンジニアによるエンジニア採用の取り組み in 2021

採用ペルソナの定義、募集要項見直し、スカウト、カジュアル面談、書類選考、面接、技術ブログ執筆、技術スタックまとめ、イベント登壇、各種タスクの資料化などなど色々やった。会社側のカジュアル面談は人生で初めてで、中途面接も片手で数えるくらいしかやったことがなかったけど、カジュアル面談・面接合わせて年間70回以上担当した。

テックカンファレンスのスポンサーも声がけしてみてGo Conference Autumn 2021や来年のGo Conference Spring 2022, PHPerKaigi 2022などのスポンサーが決まったりした。

本日開催「Go conference 2021 Autumn」に株式会社ヤプリはSilverスポンサーとして協賛しています。Yappliは2020年に Go を用いて新たなCMSへ進化しており、私たちにとって欠かせない技術です。

オフィスアワーでは、弊社のエンジニアがデモや取り組みなどお話しますのでお立ち寄りください！#gocon https://t.co/86odpTvXVt
— Yappli （ヤプリ）アプリ開発・運用・分析 (@yappli_jp) November 13, 2021

OSSの寄付（例えばPHP Foundation）の話もちょっと頭出ししていたり、Meety開設してみて、何人かカジュアル面談させてもらったりした。

Meety立ててみた！／https://t.co/LFiNJBgLbB #Meety #ノーコード
— freedomな人 (@tzm_freedom) November 19, 2021

こんな感じでとにかく色々アクションして採用現場のタスクをこなして経験値を積んでいて、結果として良い人を採用できている。アイデアだけ出して他の人にやってもらうケースもあったり色々迷惑かけていた面もあると思うw ということで人事チームや採用業務やってきたメンバーには超感謝。

ひょっとして採用が最強のエンジニアリングなのでは…？
— freedomな人 (@tzm_freedom) August 27, 2021

技術ブログとイベント登壇

採用へのチャレンジの一貫で会社の技術ブログもたくさん書いた。これまで個人ブログで400を超える技術記事を書いてきたが、会社の技術ブログに書いたのは実は初めて。書いてこなかった理由も自分のキャリアのため（会社に帰属させたくない）という思いだったんだが、自分のブログのPVは以前より気にしなくなったし、逆に会社に帰属させたほうがキャリア上メリットがありそうだったのと、なにより今の自分の興味関心がプロダクトのグロースだったので、会社の技術ブログを書くことは今はかなり前向き。結果として弊社の中で一番ブログ記事書いてるギネスな人間になっている。

社内でも「どうやってネタ出ししているのか？」とか「どう時間を使って書いているのか？」と聞かれることも増えており、継続して技術ブログを書いてきてネタを考えてきた人間の知見が役立っているのも楽しい感じ。

アーキテクチャなどカジュアル面談で説明しやすいように、かつ社内向けに認識を合わせるために記事を書いたり。

Yappliにおけるマルチテナントアーキテクチャと課題

またアウトプットがインプットを呼ぶ効果も感じていて、以下の記事は社内でも議論のネタになったりした。

社内wikiで社内共有する代わりに書いた記事もある。

また、PHP Conference 2021に登壇し、仕事の取り組みの内容を発表した。以前から仕事の取り組みをテックカンファレンスで発表してみたかったのだが、ちょうど弊社でのPHPの改善が良い感じにまとめれそうな段階だったのでCfPを出して、無事採択された。イベント登壇の時期が採用とプロジェクトが重なったりして大変だったときもあるけど乗り切れてよかった…！

PHP Conference Japan 2021でYappliの改善事例を紹介しました！

発表内容的に改善しました！的な内容なんだが実はまだ改善しきれていない部分など色々あるので今後も地道に改善していきたい。あと、PHP Conferenceは以前から聴く側として参加していたテックカンファレンスだったので登壇者として参加できて嬉しかった。

phpenv/anyenvでPHPをインストールする方法〜2021〜

Mon, 23 Aug 2021 10:30:00 +0000

phpenvまでのインストールはすんなりいくがPHPのインストールでコケがちなのでメモ

brew install bison re2c libxml2 zlib libzip libjpeg bzip2 \
 curl libiconv libedit pkg-config krb5 tidy-html5 \
 libpng icu4c oniguruma autoconf

してから.bashrcや.zshrcに以下の記述を入れる

export PATH="$(brew --prefix bison)/bin:$PATH"
export PATH="$(brew --prefix libxml2)/bin:$PATH"
export PATH="$(brew --prefix bzip2)/bin:$PATH"
export PATH="$(brew --prefix curl)/bin:$PATH"
export PATH="$(brew --prefix libiconv)/bin:$PATH"
export PATH="$(brew --prefix krb5)/bin:$PATH"
export PATH="$(brew --prefix openssl)/bin:$PATH"
export PATH="$(brew --prefix icu4c)/bin:$PATH"
export PATH="$(brew --prefix tidy-html5)/bin:$PATH"
export PKG_CONFIG_PATH="$(brew --prefix krb5)/lib/pkgconfig:$PKG_CONFIG_PATH"
export PKG_CONFIG_PATH="$(brew --prefix openssl)/lib/pkgconfig:$PKG_CONFIG_PATH"
export PKG_CONFIG_PATH="$(brew --prefix icu4c)/lib/pkgconfig:$PKG_CONFIG_PATH"
export PKG_CONFIG_PATH="$(brew --prefix jpeg)/lib/pkgconfig:$PKG_CONFIG_PATH"
export PKG_CONFIG_PATH="$(brew --prefix tidy-html5)/lib/pkgconfig:$PKG_CONFIG_PATH"

export PHP_RPATHS="$(brew --prefix zlib)/lib $(brew --prefix bzip2)/lib $(brew --prefix curl)/lib $(brew --prefix libiconv)/lib $(brew --prefix libedit)/lib"
export PHP_BUILD_CONFIGURE_OPTS="--with-zlib-dir=$(brew --prefix zlib) --with-bz2=$(brew --prefix bzip2) --with-curl=$(brew --prefix curl) --with-iconv=$(brew --prefix libiconv) --with-libedit=$(brew --prefix libedit) --with-tidy=$(brew --prefix tidy-html5) --with-external-pcre=$(brew --prefix pcre2)"

参考記事

mac新調してインストール・設定したものメモ

Mon, 23 Aug 2021 09:30:00 +0000

6年ぶりくらいにmacを新調したのでインストール・設定したことメモ

Google Chromeインストール
LastPassの拡張をインストール
Chromeで自分のGoogleアカウントにログインして同期
以下、Chromeでダウンロードしてきてインストール
- Google日本語入力
- iTerm
  - インストール後にショートカットキーを設定
- Notion
- MacVim
- Hammerspoon
- Go
- Slack
- VSCode
  - Salesforce Extension
- Jetbrains Toolbox
  - IntelliJ Ultimate
    - ideavim
    - Ruby
    - PHP
    - Python
    - Go
- Alfred
- Docker Desktop
- Clipy
ssh-keygenしてGitHubに登録
iTerm立ち上げてコマンドでインストール
- brew
- ghq
- dotfiles取ってきてよしなにインストール
- tmux
  - reattach-to-user-namespace
- anyenv
  - Ruby
  - PHP
  - Python
- prezto
- htop
- binutils
- coreutils
- tree
- tig
- wget
- hub
- jq
- mysql
- peco

VueやVuexのデータを操作するChrome拡張の作り方

Thu, 29 Apr 2021 09:30:00 +0900

Vueコンポーネントの属性値(propsやcomputedなど)やVuexのstoreを操作するChrome拡張の作り方の備忘録

概要

ContentScriptで対象のページにスクリプトをインジェクト
インジェクトしたスクリプトでVueインスタンスを取り出す
取り出したVueインスタンスをCustomEvent経由でContentScriptに渡したり、ContentScript側からCustomEvent経由で操作する

実装例

manifest.json

{
 "manifest_version": 3,
 "name": "Store Sample",
 "version": "1.0",
 "description": "",
 "content_scripts": [
 {
 "matches": [
 "https://*/*"
 ],
 "js": ["main.js"],
 "css": [],
 "run_at": "document_end"
 }
 ],
 "web_accessible_resources": [
 {
 "resources": ["inject.js"],
 "matches": ["https://*/*"],
 "extension_ids": []
 }
 ]
}

main.js

window.onload = () => {
 document.addEventListener('yourCustomEvent', function (e) {
 console.log('received', JSON.parse(e.detail));
 });

 const script = document.createElement('script');
 script.setAttribute('type', 'text/javascript');
 script.setAttribute('src', chrome.runtime.getURL('inject.js'));
 (document.head||document.documentElement).appendChild(script);
 script.remove();
};

inject.js

const $vue = document.getElementById('__nuxt').__vue__;
document.dispatchEvent(new CustomEvent('yourCustomEvent', {detail: JSON.stringify($vue.$store.state)}));

解説

以下はNuxt/Vuexの例ですが、DOMの __vue__ プロパティでvueオブジェクトを取り出せます

const $vue = document.getElementById('__nuxt').__vue__;

Vuexを使っている場合はこの中にstoreが入っていて $vue.$store.state で取得できます。

ContentScriptとページ側ではJSの実行環境が違うようで、ContentScript側ではこのオブジェクトを取得できないためページ側で取得するようにscriptタグを動的に埋め込んでいます。

書き換え操作したい場合はインジェクトしたスクリプトで __vue__ の操作を行い読み込み操作したい場合はCustomEvent経由でContentScript側に送って操作することになります。

CustomEventを使う場合はオブジェクトそのままではContentScriptに送れなかったのでJSON文字列にして送ってます。

書き換える場合はインジェクトしたJSでCustomEventをlistenしてContentScript側でイベントを送ることで任意のタイミングで書き換えることができます。

document.addEventListener('ActionEvent', function (e) {
 $vue.$store.state.about = 'hogehoge';
});

ちなみにVuexのstore以外も、コンポーネントのDOMに __vue__ プロパティが生えているので、それを使ってコンポーネントの属性を取得・操作ができます。

iOSシミュレータ・Androidエミュレータの現在位置を変更する

Thu, 15 Apr 2021 09:30:00 +0900

各シミュレータ・エミュレータでの現在位置の設定方法の備忘録

iOS

Features > Location > Custom Locationを選択

表示されるダイアログで緯度経度をセット

Android

一番下の設定からLocationを選択して地図上の適当なところを選択してから右下のSET LOCATIONボタンを押下

あるいはエミュレータ起動した状態でtelnetでエミュレータに接続してgeo fixコマンドを叩く

$ telnet localhost 5554

auth {auth_token}
geo fix {longitude} {latitude}

接続してから表示されるメッセージにも書いてあるとおり、auth_tokenは /Users/$(whoami)/.emulator_console_auth_token に入っているのでそれを使う

Litestream入門

Sun, 04 Apr 2021 09:30:00 +0900

Litestream というSQLite3をレプリケーションするOSSを調べてみました

インストール

macだと以下でインストールできます

$ brew install benbjohnson/litestream/litestream

使い方

レプリケーション先は同一ホストの任意のパスやAmazon S3を利用できます。今回はS3と互換性のあるオブジェクトストレージの MinIO を使って検証してみました。

MinIOの起動

$ docker run -p 9000:9000 minio/minio server /data

起動後は http://localhost:9000 でクレデンシャルに minioadmin を指定してログインし、適当なバケットを作成します。今回は mybkt というバケットを作成しています。

Litestream起動前にsqlite3で適当なDBを作っておきます

$ sqlite3 test.db

CREATE TABLE hoge (id int primary key);
INSERT INTO hoge VALUES (1),(2);

Litestreamを起動します

$ export AWS_ACCESS_KEY_ID=minioadmin
$ export AWS_SECRET_ACCESS_KEY=minioadmin
$ litestream replicate test.db s3://mybkt.localhost:9000/test.db

これでtest.dbに対する変更がS3にレプリケーションされ、リストアできるようになります。

設定ファイル

コマンド引数で対象のSQLite3のDBファイルやレプリケーション先を指定できますが、設定ファイルを使うと複数DB・レプリケーション先を指定できます

access-key-id: minioadmin
secret-access-key: minioadmin
dbs:
 - path: /path/to/test1.db
 replicas:
 - url: s3://mybkt.localhost:9000/test1.db
 - path: /path/to/test2.db
 replicas:
 - path: /path/to/replica
 - name: test2-1
 url: s3://mybkt.localhost:9000/test2-1.db
 - name: test2-2
 url: s3://mybkt.localhost:9000/test2-2.db

nameは省略可能で、省略するとタイプの名前(s3やfile)が適用されます。 nameは各DBに対してユニークにする必要があるので、レプリカ先に同じタイプを複数利用する場合はnameを指定する必要があります。

rqlite入門

Sun, 04 Apr 2021 09:30:00 +0900

rqlite というバックエンドにSQLite3を使った分散DBについて調べてみました

インストール

macの場合こんな感じでインストールできます

$ curl -L https://github.com/rqlite/rqlite/releases/download/v5.10.2/rqlite-v5.10.2-darwin-amd64.tar.gz -o rqlite-v5.10.2-darwin-amd64.tar.gz
$ tar xvfz rqlite-v5.10.2-darwin-amd64.tar.gz
$ cd rqlite-v5.10.2-darwin-amd64
$ cp rqlite /usr/local/bin/rqlite
$ cp rqlited /usr/local/bin/rqlited
$ cp rqbench /usr/local/bin/rqbench

使い方

各ノードのサービスの立ち上げはrqlitedでできます。
今回はシングルホストでクラスタリングを検証するため、↓をそれぞれ別シェルで実行します。

$ rqlited -node-id 1 ./node.1
$ rqlited -node-id 2 -http-addr localhost:4003 -raft-addr localhost:4004 -join http://localhost:4001 ./node.2
$ rqlited -node-id 3 -http-addr localhost:4005 -raft-addr localhost:4006 -join http://localhost:4001 ./node.3

↑の場合はリーダーノードは 1 のノードになります。

データ操作するにはHTTP APIを使うことになりますが、CLIのクライアント rqlite も用意されています。

$ rqlite

> CREATE TABLE hoge (id int primary key);
> INSERT INTO hoge VALUES (1),(2),(3);
> SELECT * from hoge;
+----+
| id |
+----+
| 1 |
+----+
| 2 |
+----+
| 3 |
+----+

リーダーノードはrqliteのコマンド .status かStatus APIで確認可能です

Diagram Maker動かしてみた

Sat, 27 Feb 2021 09:00:00 +0000

DiagramMakerを動かしてみたので備忘録。
すぐ動くサンプル無さそうだったので…

サンプルはここに置いてます https://github.com/tzmfreedom/javascript-sample/tree/master/diagram-maker-sample

インストール

$ npm install diagram-maker

TypeScriptじゃなくても動くようですが公式のサンプルがTypeScriptだったり、ちゃんとstyleあてないといけないといけなかったりするので webpackや各種loaderも併せて一式インストール

$ npm install @types/node \
 style-loader \
 css-loader \
 sass \
 sass-loader \
 typescript \
 ts-loader \
 dagre \
 redux \
 webpack \
 webpack-cli

ざっと使い方

セレクタを指定して要素に対してDiagramMakerをアタッチするような使い方になるので、HTMLにそれ用の要素を用意します。

<!DOCTYPE html>
<html>
 <head>
 <meta charset="UTF-8">
 <title>DiagramMaker Test Environment</title>
 </head>
 <body>
 <div id="diagramMakerContainer"></div>
 <div id="diagramMakerLogger"></div>
 <script src="./bundle.js"></script>
 </body>
</html>

JSはこんな感じで書く。第一引数はマウントするセレクタ。

import { DiagramMaker } from 'diagram-maker';

const config = {
 // ...
};
const initData = {
 // ...
};
const diagramMaker = new DiagramMaker(
 'diagramMakerContainer',
 config,
 // optionParams
 {
 initialData: initData
 }
);

configの例

SQLite3の備忘録

Sat, 27 Feb 2021 09:00:00 +0000

SQLite3 の備忘録

手軽に独自関数を定義できる

組み込みなので独自関数をプラグインとして事前ビルドすることなくアプリケーション内で定義して利用できる。
以下、PHPでやる例↓

<?php
 
 $db = new \PDO('sqlite::memory:');
 $db->setAttribute(\PDO::ATTR_ERRMODE, \PDO::ERRMODE_EXCEPTION);
 // ユーザー定義関数 regexp を登録
 $db->sqliteCreateFunction('hello', function() {
 return 'world';
 });
 $stmt = $db->query('SELECT hello();');
 var_dump($stmt->fetchAll());

SQLite3にはLIKEのような比較演算子としてREGEXPが使えるのだが、これを利用するには事前にユーザ側でregexp()の独自関数を定義する必要がある。

<?php

$db = new \PDO('sqlite::memory:');
$db->setAttribute(\PDO::ATTR_ERRMODE, \PDO::ERRMODE_EXCEPTION);
$db->sqliteCreateFunction('regexp', function($pattern, $value) {
 mb_regex_encoding('UTF-8');
 return (false !== mb_ereg($pattern, $value)) ? 1 : 0;
});
$stmt = $db->query("SELECT 'world' REGEXP '^worl.*'");
var_dump($stmt->fetchAll());

mode=roでもflockされる

Goで以下のURI filenamesでシステムコールを見てみると… file:example.sqlite?mode=ro&nolock=0

$ sudo dtruss ./main 2>&1 | grep fcntl

fcntl(0x0, 0x3, 0x0) = 2 0
fcntl(0x1, 0x3, 0x0) = 1 0
fcntl(0x2, 0x3, 0x0) = 1 0
fcntl_nocancel(0x3, 0x32, 0x7FFEEFBFEAE0) = 0 0
fcntl(0x3, 0x7, 0x7FFEEFBFDDA0) = 0 0
fcntl(0x3, 0x8, 0x7FFEEFBFE858) = 0 0
fcntl(0x3, 0x8, 0x7FFEEFBFE858) = 0 0
fcntl(0x3, 0x8, 0x7FFEEFBFE858) = 0 0
fcntl(0x3, 0x8, 0x7FFEEFBFE340) = 0 0
fcntl(0x3, 0x8, 0x7FFEEFBFEE58) = 0 0
fcntl(0x3, 0x8, 0x7FFEEFBFEE58) = 0 0
fcntl(0x3, 0x8, 0x7FFEEFBFEE58) = 0 0
fcntl(0x3, 0x8, 0x7FFEEFBFEE60) = 0 0

nolock file:example.sqlite?mode=ro&nolock=1 の場合

2021

Fri, 01 Jan 2021 00:00:00 +0900

2020年の振り返り

Wed, 30 Dec 2020 09:30:00 +0000

仕事関連

転職

今年の２月に某ノーコードスマホアプリ開発プラットフォームな会社に転職。

転職理由としてはこんな感じ↓

ライフステージ的にも仕事的にも一区切りついた感があった
前職でやりたかったこと（自社サービスの開発・保守の経験を積むことと、それによってエンジニアリング力を高めたいという思い）はある程度達成できた感覚があった
エンジニアリング力に関しては良い評価をもらうことが増えてきて貢献度合いとしても最後の一年で納得感を得られた
改めて自分のやりたい仕事を突き詰めて技術力も仕事力も高めていきたいなという思い
カジュアル面談で良い会社と出会えたこと

ノーコード・ローコードなSalesforceを主軸としたシステム開発をやっていた１社目の経験と
チーム開発やエンジニアリング力を磨くことができた２社目の経験と
アプリ開発自体にハードルを感じていた自身の思いとプロダクトの面白さ、成長性
このあたりが決め手になった感じ。
そういうわけで今回の転職はこの１社しか受けていない。

前職に大きな不満があるわけではなく、労働環境・福利厚生も良かったし
中堅としてこれから引っ張っていく立場な中で辞めるのは心苦しい感じでもあったのだけど
いつ人生が終わるかわからんし、タイミングとしても今を逃したくないという思いが強かった。

結果として、転職して一年近く経った今でもプロダクトやチームに大きな魅力を感じていて
営業や導入・運用サポートも含めてプロダクトをもっと良くしていきたい気持ちがあり
結果論としても良い転職になったなぁと思う。

今年やった仕事

要望・改善・不具合系チケットの大量消化
新機能プロジェクトのフロント・サーバーサイド担当
レガシーPHPアプリケーション改善（E2Eテスト・単体テスト・静的解析導入・リファクタリング）
Go/gRPCアプリケーションの結合テスト追加・CI調整
暗黙知の形式知化（コンフルと社内勉強会での共有）
オオカミ少年アラート対応（ログレベルの精査・Sentryの設定調整・リトライ/タイムアウト値などの実装調整）

チケット数としては100個ほど。PRだと400くらい。
気づいたら改善系の年間リリース数がトップだったり、GitHubのInsightsで見ても主要リポジトリのAdditionで２位〜４位くらいのコントリビューションになってた。
新機能開発や改修、障害対応を通じてドメイン知識や既存アーキテクチャを理解しつつ
暗黙知になっているドメイン知識を形式知化したり
テストコード自体を増やしたり結合テストが書けるようにしてデグレを事前に検知可能にしたり（というかテスト書く過程で既存の不具合を発見したり）
ログレベルを精査して大事なエラーアラートを見逃さないようにしたり
短期的に効く機能改善・追加も進めつつ、こういった中長期的に効く施策もガンガンやっていった。
Salesforceの実装相談を受けたり、汎用的に使えそうなRedashのクエリ作って共有したり、会社全体のスループットを上げるような仕事もできた。
結果として自動テスト・PHP・簡易的なデータ分析・その他ドメイン知識などなど
エンジニアチームの中で 詳しい人 として動けているし頼られることも増えてきた。

技術要素としては、Go/gRPC/TypeScript/Nuxt/Vue/PHP/Laravelあたりを中心に。
PHP以外は業務で扱うのは初めてだったんだけど業務に差し支えないレベルで会得できた感触がある。
手元でiOS/Androidシミュレータを動かしながら動作確認するのもだいぶ慣れてきた。

来年はもう少し技術を深堀りしつつ、さらにドメイン知識を習得して良い感じに回していければ良いかなと。
視座も上げつつ課題に対する賢い解決方法をより提案・実行できれば良いなぁ。

副業

今年は副業にチャレンジしてみた。

今のところSalesforceに関する技術的な相談を受けたりサンプル作ったり実装したり、という仕事を請け負っている。

モチベーションとしては小遣い稼ぎ的な資金面もあるが、その会社の課題に対して自分の能力（Salesforceのノーコード〜プロコードの知識と一般的なWebエンジニアリング）が活かせそうだなと思ったのもある。

Salesforce以外の副業もやりたい気持ちはあるのだが、実際に手を動かす系になるとあんまりワークしなさそうな感覚がありトライできていない。レガシー改善に興味があるんだが、そういう仕事はドメイン知識が必要だったり、信頼貯金やスピード感的にもフルコミットじゃないと厳しい感じがしている。
いずれにせよ、チャレンジした結果、こんな感じで継続してできそうなボリューム感や請け負えそうな仕事内容がわかったのは収穫だった。

ということで副業自体はもう少し色々試してみたいと思っているので
興味が有る方はお声をかけていただけると嬉しいかも。

ブログ/OSS/登壇

今年はブログ記事を全然書かなかった。登壇もPHPerKaigiだけ。OSSコントリビューションもほぼ無し。
というか今年は意識的にこれらをやらないようにした。
業務時間外に勉強する時間を極力減らして、技術は極力業務時間内で学ぶようにアプローチを変えてみた。
キャッチアップのための勉強やスマホアプリ開発のHelloWorldをやったときもあったのだけど
例年と比べるとプライベートで技術系の本はあんまり読んでないしコードも書いていない。

仕事の中で成長する要素というのはまだまだ有るので、今のところこのアプローチでうまくいっていると感じている。
仕事で使わない技術はすぐ忘れるので、LazyLoadなアプローチで勉強するのが自分には合っていそうだなとも思う。

逆に仕事でどうやればもっとうまくできるのか、っていうのはプライベートでも考えてしまうようになっていて
これは良いのか悪いのかは全くわからない。
もう少し仕事のモチベーションをコントロールできるとバランスが取れてメンタル的にも良いのかもしれない。

また、正直なところ、技術に対する飽きみたいなのがちょっと来ているのもある。
今のところそれによる危機感みたいなのは無いんだけど、「あれ、これが35歳なんちゃら説ってやつなのかな」とも思ったり。
実装スピードもそんなに衰えている感じがしないし、課題に対する視座も年々少しずつ高くなっていて
仕事のエンジニアリング力に関してはあまり心配していないのだが、技術に対するトキメキ・ワクワクが減ったなぁと。
あと何の技術にせよ見返りみたいなのを変に意識するようになってしまっている。
具体的には仕事で利用できそうかどうかで判断してしまっていて、それが原因でつまらなくなっていそうな感じもする。

ApexからGoogle APIを叩くときのサンプル

Mon, 19 Oct 2020 09:30:00 +0000

ApexからGoogle Drive API, SpreadSheet APIを叩くAPIクライアントのサンプル書いてみたので備忘録。

サンプルはこちら https://github.com/tzmfreedom/apex_google_api

事前準備

GoogleのAPIを設定
- Developer ConsoleからGoogle Drive API, SpreadSheet APIを有効化
- OAuth2.0クライアントIDを作成
認証プロバイダを作成
- クライアントID／シークレットはGoogle Developer Consoleで取得したものを利用
- 承認エンドポイントAPI => https://accounts.google.com/o/oauth2/auth?access_type=offline&approval_prompt=force
  - access_typeとapproval_promptを入れないとrefresh token取得できないので注意（初回であればapproval_promptを入れなくても良いが２回目以降の認可をする場合は必要）
- トークンエンドポイントAPI => https://oauth2.googleapis.com/token
named credential（指定ログイン情報）の作成
- ↑の認証プロバイダを指定
- スコープ => https://www.googleapis.com/auth/drive openid email
- Drive APIのURLは https://www.googleapis.com
- SpreadSheet APIのURLは https://sheets.googleapis.com
参考: https://qiita.com/sikj/items/1b0f51d3f9f119dc322c

サンプルのAPIクライアントの使い方

Drive API

フォルダの作成

GoogleDriveAPIClient client = new GoogleDriveAPIClient();
GoogleDriveCreateResponse response = client.createFolder('FolderName', 'ParentID');

ファイルのコピー

GoogleDriveCreateResponse response = client.copyFile('SourceID', 'DestFileName', 'ParentID');

SpreadSheet API

スプレッドシートの値を更新

SpreadSheetAPIClient client = new SpreadSheetAPIClient();
List<SpreadSheetUpdateValue> values = new List<SpreadSheetUpdateValue>();
values.add(new SpreadSheetUpdateValue('シート1!A1:D5', new List<List<Object>>{
 new List<Object>{
 1,
 2,
 3,
 4
 },
 new List<Object>{
 11,
 22,
 33,
 44
 }
}));
client.updateValues('xxx', values);

その他

スプレッドシートの更新のAPIは３種類ある
- 参考: https://qiita.com/howdy39/items/c28c0328038d9c43f389#%E3%81%9D%E3%81%AE%EF%BC%93-spreadsheetsvaluesbatchupdate

PHPのE2EテストでHTTPリクエストをモックする方法

Thu, 17 Sep 2020 22:30:00 +0000

背景

自動テストの文脈でアプリケーションが外部に対してHTTPリクエスト行う場合
一般的には以下のパターンで行うことが多いと思います。

DIやDIコンテナの仕組みでアプリケーション的にHTTPクライアントをモック
実際のDB、コードを使うアプリケーションサーバをたてる
仮のレスポンスを返すテスト用のモックサーバをたてる

ユニットテストの場合はアプリケーション的にHTTPクライアントをモックすることが多いと思いますが、リモートホストに対してテストを行うE2Eテストだとアプリケーションサーバやモックサーバを立てる手法を取ることが多いと思います。

しかしながら、実際のアプリケーションサーバやテスト用のモックサーバを立てるのはやや面倒ですし
実用的にはテストを行うホストから適切にHTTPレスポンスをコントロールできるような調整も必要です。

そこで今回は php-vcr とauto_prepend_fileを使って E2Eテスト時の外部HTTPリクエストをモックする方法を紹介します。

方法

以下のようなPHPスクリプトを作成して、auto_prepend_fileに指定すれば
テスト側からphp-vcrのcassetteをコントロールしつつ外部HTTPリクエストをモックできます。

<?php

class MockHandler
{
 public function __construct($cassetteName)
 {
 // After turning on the VCR will intercept all requests
 \VCR\VCR::turnOn();
 
 // Record requests and responses in cassette file 'example'
 \VCR\VCR::insertCassette($cassetteName);
 }

 public function __destruct()
 {
 // To stop recording requests, eject the cassette
 \VCR\VCR::eject();
 
 // Turn off VCR to stop intercepting requests
 \VCR\VCR::turnOff();
 }
}

$cassetteName = $_SERVER['HTTP_X_VCR_CASSETTE'];
$_mockHandler = new MockHandler($cassetteName);

テストのHTTPリクエストのヘッダに X-VCR-CASSETTE を指定すればカセットをコントロールできるようになっています。
リモートホスト側にカセットファイルを置く必要はありますが、リクエストごとにカセットを指定することでHTTPレスポンスをコントロールできます。

リモートホストで動くPHPアプリケーションに対するE2Eテストでカバレッジを測定する方法

Tue, 15 Sep 2020 22:30:00 +0000

リモートホストで動くPHPアプリに対してE2Eテストをしたときのカバレッジを計測する方法を紹介します。

なお、こちらの記事を参考にしています（というかほぼ同じです）

PHP Code Coverage for your web/selenium automation · Tech Adventures by Tarun Lalwani

原理としてはリモートホスト上のスクリプトが実行する前に xdebug_start_code_coverage() などのカバレッジ計測の関数を呼び出しスクリプトが終了する前に xdebug_stop_code_coverage() xdebug_get_code_coverage() を呼び出してカバレッジを別ファイルに保存。保存されたカバレッジファイルを集計してカバレッジのHTMLファイルを吐き出します。

1. スクリプトが実行する前にxdebug_start_code_coverageを呼び出す

PHPにはauto_prepend_fileという事前に呼び出すスクリプトを指定する仕組みがあります。

具体的にはphp.iniやapache/nginxの設定ファイルに以下のような記述をすることで
指定したファイルがrequireされた状態でリクエストされたPHPファイルが呼び出されることになります。

php.ini

auto_prepend_file=/path/to/start.php

apache

php_value auto_prepend_file "/path/to/start.php"

nginx

fastcgi_param PHP_VALUE "auto_prepend_file=\"/path/to/start.php\"";

事前に呼び出すスクリプトファイルはこちらです。

<?php

xdebug_start_code_coverage(XDEBUG_CC_UNUSED | XDEBUG_CC_DEAD_CODE);

class CoverageDumper
{
 private string $testName;

 function __construct(string $testName)
 {
 $this->testName = $testName;
 }

 function __destruct()
 {
 $coverageName = '/path/to/coverage/coverage-' . $this->testName . '-' . microtime(true);
 try {
 xdebug_stop_code_coverage(false);
 $codecoverageData = json_encode(xdebug_get_code_coverage());
 file_put_contents($coverageName . '.json', $codecoverageData);
 } catch (Exception $ex) {
 file_put_contents($coverageName . '.ex', $ex);
 }
 }
}

$testName = (isset($_COOKIE['test_name']) && !empty($_COOKIE['test_name'])) ? $_COOKIE['test_name'] : 'unknown_test_' . time();
$_coverageDumper = new CoverageDumper($testName);

コード計測にはxdebugを使うのでリモートホスト先で有効化する必要があります。最初に xdebug_start_code_coverage() でカバレッジ計測を開始し CoverageDumperのデストラクタに xdebug_stop_code_coverage() xdebug_get_code_coverage() を仕込むことで呼び出し先のスクリプトが終了したときにカバレッジを書き出してくれるようになります。

goでvimのようなTUIテキストエディタを作ってみた

Sun, 22 Mar 2020 09:30:00 +0000

goでvimのようなエディタを作ってみました

tzmfreedom/myvim

インストール

$ go get github.com/tzmfreedom/myvim

使い方

$ myvim /path/to/file

実装方法

基本的には

描画
キー入力の繰り返しです。

描画はエスケープシーケンスで座標0:0にしたり画面クリアしたりしてます。

キー入力によってコマンドモードと入力モードを切り替えたりコマンドを解釈してます。キーイベントはtermboxでハンドリングしてます。

text/templateを使って良い感じにファイルジェネレートできるprotocプラグインを作った

Sun, 22 Mar 2020 09:30:00 +0000

Goのtext/templateのリテラルで記述されたテンプレートファイルを使って、protofileからファイルを出力するprotocプラグインを作ってみましたー。
protobufで自動生成されるファイル郡以外にも自動でコードジェネレートしたいというのがモチベーション。

protoc-gen-template

protocのプラグインの作り方はこちらを参考にしました

protocプラグインの書き方 - Qiita

インストール方法

$ go get github.com/tzmfreedom/ptoroc-gen-template

使い方

protocで–template_outを指定すればOK

$ protoc -I. --template_out=/path/to/template:. target.proto

テンプレートファイルはこんな感じでtext/templateで書きます

type {{ .Prefix }}{{ .Name }} struct {
 {{ range .Fields -}}
 {{ getName .Name }} {{ propertyType . $.PackageName }}
{{ end -}}
}

これにこんな感じなprotoを食わせると

syntax = "proto3";

package helloworld;


// The request message containing the user's name.
message HelloRequest {
 string name = 1;
}

// The response message containing the greetings
message HelloReply {
 string message = 1;
}

こういうファイルが出力されます

protocのApexプラグインを作った

Sat, 21 Mar 2020 22:30:00 +0000

protobufの勉強がてらprotocのApexのプラグインを作ってみました

protoc-gen-apex

インストール方法

$ go get github.com/tzmfreedom/protoc-gen-apex

使い方

メッセージだけ作成

$ protoc -I. --apex_out=. target.proto

サービスクライアントも作成

$ protoc -I. \
 -I${GOPATH}/src \
 -I${GOPATH}/src/github.com/grpc-ecosystem/grpc-gateway/third_party/googleapis \
 --apex_out=host=example.com/hoge:. hello.proto

サービスクライアントを作成するときはgrpc-gatewayを使う前提のコードになっているのでこんな感じでprotoファイルを記述します

syntax = "proto3";

import "google/api/annotations.proto";

package helloworld;

// The greeting service definition.
service Greeter {
 // Sends a greeting
 rpc SayHello (HelloRequest) returns (HelloReply) {
 option (google.api.http) = {
 post: "/v1/say_hello"
 body: "*"
 };
 }
}

例

protoファイル

syntax = "proto3";

package helloworld;

import "google/api/annotations.proto";

// The greeting service definition.
service Greeter {
 // Sends a greeting
 rpc SayHello (HelloRequest) returns (HelloReply) {
 option (google.api.http) = {
 post: "/v1/say_hello"
 body: "*"
 };
 }
 rpc GetTask(HelloRequest) returns (HelloReply) {
 option (google.api.http) = {
 get: "/v1/get_task"
 };
 }
}

// The request message containing the user's name.
message HelloRequest {
 string name = 1;
 int32 a = 2;
 int64 b = 3;
 Hoge c = 4;
 repeated string d = 5;
 message Hoge {
 string name = 1;
 }
}

// The response message containing the greetings
message HelloReply {
 string message = 1;
}

出力ファイル

2020

Wed, 01 Jan 2020 00:00:00 +0900

2019年の振り返り

Tue, 31 Dec 2019 09:30:00 +0000

恒例？の年末振り返り

仕事

あんまり外で仕事の話をしないのでたまにはｗ
プライベートでSalesforce関連のアクティビティが多くて、たまに仕事の心配されるんだけどそうじゃないんですよって言いたいｗ

現職に来てから昨年までの約２年くらいはRuby/Railsのサービス開発に携わっていたんだけど、今年はPHPのサービスをメインでやっていた一年でした。 PHPは前職で簡単なフォームやバッチ処理を作る程度の経験だったので、がっつりWebサービス開発業やって色々と勉強になったし、今のPHPはエコシステム的にも言語仕様的にもかなり良くなってきているなと感じました。特に型付けに関しては他のLLには無い表現力があったり静的解析ツールのPHPStanやIDEが優秀だったり、書きやすくかつ堅牢な言語になっているなと実感しました。

具体的な仕事としては

サービスのSymfonyのバージョンを2.4 => 3.4 => 4.2にアップグレード
15年以上続く独自フレームワークな老舗Webアプリ（600万ユーザ、〜70万行）のPHPのバージョンを5.6 => 7.1にした
それにあわせて依存パッケージを最新にアップグレードしたり、精査して別のパッケージに切り替えた
定期アップグレードする仕組みを作った
PHPStan導入したりdeclare(strict_types=1)した
Opcache使って不要っぽいファイルの当たりを付けてガンガン削除していった
インフラレベルでのちょっとした改善

と、まぁいわゆるTHE改善業でした。
ちなみにどのWebサービスも はじめまして 状態からスタートしてそれなりのスピード感で改善できていたので、キャッチアップ力も我ながら良かったと思います。そういや俺、１年以上携わってるサービス無いな…ｗ

インフラ周りだとCloudFormationに初めて触ったんですが、PRで差分確認できたりChangeSet適用ポチっとするだけで適用できるのは良いな〜とIaCの良さを実感。

あと、色々と改善業してみてわかったのが「テストがないコードはレガシー」というのはマジだな、ということ。

逆にここだけちゃんとやっていればリファクタリングしてなんとか挽回できたり仕様の把握もテストコードレベルで確認できたりするけどそれが無いと、よりアンタッチャブルで経年劣化していくものなんだなぁというのも思いました。 LLなので削除漏れも検知できず結果として大量の不要ファイルが溢れたり。静的解析や静的型付け言語・型推論あたりはトレンドだし意味があると思うけど、テストコードを書く（書けるようにする）ことが一番品質を上げやすいと思います。

あとDBの負債はいろんなところに伝搬するし変更しづらいので、DBの設計は注意しないといけないなと思いました。ロールバックもしづらいし…

ちなみに大量の不要ファイルの削除はOpcache法でやったんだけど本当に簡単で便利な方法なので、不要ファイルを検知したい場合は是非ご活用ください。

OSS

Contributionは880くらいでした〜。意外と例年より多かったｗ

が、PR/issueは全然出さず…未マージのものも含めるとこんな感じっす

全部PHP…ｗアップグレードしていくときに困ったところでPRを上げていったという感じ。

Salesforceのオブジェクト定義から文字列を出力できるジェネレータを作った

Mon, 23 Dec 2019 09:00:00 +0000

Salesforceのオブジェクト定義を使って文字列を出力できるジェネレータを作ってみましたー

sf-metadata-converter

モチベーションとしては、VF + JSRemoting + Frontのフレームワークな構成を試していたんだけど SObjectの定義を使ってJSやApexのファイルを作成する必要があったので若干面倒だったというやーつ

使い方

インストール

$ npm install -g sf-metadata-converter

ID/PWDは環境変数で指定して叩くと、テンプレートにSObjectの定義をパラメータとしてバインドした文字列が標準出力に出力されます

$ export SALESFORCE_USERNAME=xxx
$ export SALESFORCE_PASSWORD=xxx
$ sfmconv -T {SObject Name} -t {template file}

template fileはEJSでこんな感じで書きます

class <%= name %> {
 constructor() {
 this.params = [<%- fields.map(f => `'${f.name}'`).join(','); %>];
 }
}

ビルトインのテンプレートも持っていて、js typescript apex を指定するとそれっぽいのが表示されます

テンプレートにはURLの指定もOK

$ sfmconv -T Account -t "https://httpbin.org/get?q=%3C%=%20name%20%%3E"

バインドしているパラメータはjsforceでmetadata describeしたときのレスポンスが入ります

Apexのテストデータ作成とかSObjectのTypeScriptの型定義やJSのクラス生成とかに役立つのではないかと思いまっす

Opcacheによる不要ファイルの検知

Mon, 09 Dec 2019 16:00:00 +0000

PHPのOpcacheの関数を使うと参照されていないコード（不要ファイル）を確認することができます。

例えばこんな感じなファイルを作ってアクセスするとOpcacheに載っているファイル一覧を取得できます。

<?php

header("Content-Type: text/csv");
define('CACHEPREFIX', function_exists('opcache_reset')?'opcache_':(function_exists('accelerator_reset')?'accelerator_':''));

$status = call_user_func(CACHEPREFIX.'get_status');
foreach ($status['scripts'] as $data) {
 echo $data['full_path'] . "\t" . $data['hits'] . PHP_EOL;
}

出力されたファイル一覧と実ファイル一覧を付け合わせることで、参照されていないコードを確認できます。

SAPIごとに管理されているようで、CLIとWeb（mod_phpとか）は別のOpcacheが使われているのでWebで参照されているかどうかを見る場合には CLIではなくWebからアクセスしてPHPを実行させる必要があるっぽいです。

また、設定値によってOpcacheに載ってくる条件も多少変わってくるので注意です。例えばファイルベースのOpcacheが有効でない場合は再起動後はキャッシュがクリアされていたり、max_accelerated_filesが少ないと載らないファイルも出てくると思います。

SOQLのdatabase/sqlドライバーを作った

Mon, 09 Dec 2019 16:00:00 +0000

database/sqlのsqlドライバーを使ってSalesforceのSOQLを動かしてみましたー

tzmfreedom/go-soql-driver

ということで使い方とdatabase/sqlのドライバーの作り方を備忘として残しておきます。

使い方

$ go get github.com/tzmfreedom/go-soql-driver

して、以下のようにして使います

package main

import (
	"database/sql"
	"fmt"
	"net/url"
	"os"

	soqlDriver "github.com/tzmfreedom/go-soql-driver"
)

func main() {
	username := os.Getenv("SFDC_USERNAME")
	password := os.Getenv("SFDC_PASSWORD")
	dsn := soqlDriver.CreateDsn(url.QueryEscape(username), url.QueryEscape(password), "login.salesforce.com")
	db, err := sql.Open("soql", dsn)
	if err != nil {
		panic(err)
	}
	rows, err := db.Query("SELECT Id, Name FROM Account")
	if err != nil {
		panic(err)
	}
	for rows.Next() {
		var id, name string
		rows.Scan(&id, &name)
		fmt.Println(id, name)
	}
}

func insert(db *sql.DB) {
	r, err := db.Exec("INSERT INTO Account(Name) VALUES ('Created By sql driver')")
	if err != nil {
		panic(err)
	}
	fmt.Println(r.RowsAffected())
}

func update(db *sql.DB) {
	r, err := db.Exec("UPDATE Account SET Name = 'Updated By sql driver' WHERE Name = 'Created By sql driver'")
	if err != nil {
		panic(err)
	}
	fmt.Println(r.RowsAffected())
}

func delete(db *sql.DB) {
	r, err := db.Exec("DELETE FROM Account WHERE Name = 'Updated By sql driver'")
	if err != nil {
		panic(err)
	}
	fmt.Println(r.RowsAffected())
}

SOQLにはINSERT, UPDATE, DELETE構文はありませんが、よしなに変換してDMLを発行しています。

GoからRubyのDSLを読み込む方法

Mon, 09 Dec 2019 09:00:00 +0000

この記事はGo5 Advent Calendar 2019の9日目の記事です。

RubyのDSLは表現力が高く書きやすいのですが、Ruby以外の言語からDSLを読み出すには何かしらのRubyのランタイムが必要です。

そこで今回は、Go言語でmrubyを使ってRubyのDSLを読み込む方法を紹介します。

mitchellh/go-mrubyのインストール

mitchellh/go-mrubyはgo getでインストールできないので、リポジトリを取ってきて事前にmakeしておく必要があります。 ghqだとこんな感じ。

$ ghq get mitchellh/go-mruby
$ cd ${GOPATH}/src/github.com/mitchellh/go-mruby
$ make

depを使う場合はdep ensureした後、vendor配下でmakeすればOK

$ cd vendor/github.com/mitchellh/go-mruby
$ make

go-mrubyでRubyファイルの実行

以下のようにして、GoでRubyのファイルを実行することができます

package main

import (
	"errors"
	"fmt"
	"github.com/mitchellh/go-mruby"
	"io/ioutil"
)

func main() {
	var username, value string
	var isInConfig bool
	var rubyErr error
	mrb := mruby.NewMrb()
	defer mrb.Close()
	kernel := mrb.KernelModule()
	kernel.DefineMethod("username", func(m *mruby.Mrb, self *mruby.MrbValue) (mruby.Value, mruby.Value) {
		username = m.GetArgs()[0].String()
		return nil, nil
	}, mruby.ArgsReq(1))
	kernel.DefineMethod("config", func(m *mruby.Mrb, self *mruby.MrbValue) (mruby.Value, mruby.Value) {
		args := m.GetArgs()
		isInConfig = true
		mrb.Yield(args[0])
		isInConfig = false
		return nil, nil
	}, mruby.ArgsReq(1))
	kernel.DefineMethod("set", func(m *mruby.Mrb, self *mruby.MrbValue) (mruby.Value, mruby.Value) {
		args := m.GetArgs()
		if !isInConfig {
			rubyErr = errors.New("set should be called in config")
			return nil, nil
		}
		value = args[0].String()
		return nil, nil
	}, mruby.ArgsReq(1))

	b, err := ioutil.ReadFile("./config")
	_, err = mrb.LoadString(string(b))
	if err != nil {
		panic(err.Error())
	}
	if rubyErr != nil {
		panic(rubyErr.Error())
	}
	fmt.Println(username)
	fmt.Println(value)
}

上の例だと以下のようなRubyのDSLを読み込めます

SalesforceのOS `salesfOS` を作った

Thu, 05 Dec 2019 09:00:00 +0000

この記事は Salesforce Platform Advent Calendar 2019 - Qiita 第5日目の投稿です。

ネタです。ご査収ください。

salesfOS

※最初に左下のアプリバーのボタンでログインしてね

リポジトリ: tzmfreedom/salesfOS

利用技術あれこれ

ふつーの静的webサイト
jsforce + jsforce-ajax-proxy on Heroku
JSFrame.jsでそれっぽいウィンドウを生成
onmousedown, onmousemove, onmouseupでいい感じにアイコンのドラッグアンドドロップを実現

使い方

左下のアプリバーのボタンを押すと認証・認可画面に遷移する。ここで認可しないとAPIっぽい機能は使えない
適当にアイコンをダブルクリックしたりドラッグ＆ドロップしたりゴミ箱に放り込んでください

今後の展望

もう少しOS感出す
- ファイルエクスプローラー
- ユーティリティを充実させる
機能も充実させる
- デプロイ
- Apexコード書けたら面白そう
jQuery卒業してReact使う（突貫で作ったので…
そういやウィンドウの最大化・最小化実装するの忘れてた

雑記

去年のアドカレで全力でモノづくりしすぎたせいか、ネタが尽きていた
去年の私の記事、CLIネタが多かったしLANDも含めて結構地味だった
adminにもわかりやすさを出すために画面が良いよね感
OSもどき楽しそう
でも、この着想に至るまでにsfyncというRuby DSLでオブジェクトデプロイできるツールを中途半端に開発してたんだよね…

いずれ本当のOSも自作してみたいなぁと思いつつ、今回のWebで作るOSもどきもめっちゃ面白かったので引き続き続けたい気持ち

PHPでPHPを実装する

Tue, 03 Dec 2019 09:00:00 +0000

この記事はPHP Advent Calendar 2019の3日目の記事です。

言語実装入門編として、PHPでPHPを実装してみました。

AST生成はPHP-Parserに一任
バイトコードやバイナリ生成などはせず、Tree Walkなインタープリターとして実装

という感じで作っていきます。

実装したものはこちら↓

tzmfreedom/phphp

composer global require tzmfreedom/phphp でもインストールできます

HelloWorld

まずは composer require nikic/php-parser してPHP-Parserを追加します。

基本形はこんな感じになります。

<?php

require_once 'vendor/autoload.php';

use PhpParser\ParserFactory;
use PhpParser\Parser;
use PhpParser\NodeDumper;

class PHPInterpreter
{
 /**
 * @var Parser
 */
 private $parser;

 public function __construct(Parser $parser)
 {
 $this->parser = $parser;
 }

 public function run(string $code)
 {
 $ast = $this->parser->parse($code);

 // $dumper = new NodeDumper;
 // echo $dumper->dump($ast);

 foreach ($ast as $stmt) {
 $this->evaluate($stmt);
 }
 }

 public function evaluate($node)
 {
 switch (get_class($node)) {
// ...
 }
 }
}

$code = file_get_contents($argv[1]);
$parser = (new ParserFactory)->create(ParserFactory::PREFER_PHP7);
$interpreter = new PHPInterpreter($parser);
$interpreter->run($code);

ParserFactoryでパーサを生成してParser#parseを呼び出すとPHPの文字列からASTを生成してくれます。 ASTはStatementの配列になっているので evaluate で順に処理していってます。

RustのSalesforce APIクライアント `rustforce` をリリースしました

Sun, 06 Oct 2019 22:30:00 +0900

RustのSalesforce REST APIクライアントのrustforceをリリースしました

使い方

クエリ例はこんな感じで

use rustforce::Client;
use rustforce::response::{QueryResponse, ErrorResponse};
use serde::Deserialize;
use std::env;

#[derive(Deserialize, Debug)]
#[serde(rename_all = "PascalCase")]
struct Account {
 #[serde(rename = "attributes")]
 attributes: Attribute,
 id: String,
 name: String,
}

#[derive(Deserialize, Debug)]
struct Attribute {
 url: String,
 #[serde(rename = "type")]
 sobject_type: String,
}

fn main() {
 let client_id = env::var("SFDC_CLIENT_ID").unwrap();
 let client_secret = env::var("SFDC_CLIENT_SECRET").unwrap();
 let username = env::var("SFDC_USERNAME").unwrap();
 let password = env::var("SFDC_PASSWORD").unwrap();

 let mut client = Client::new(client_id, client_secret);
 client.login_with_credential(username, password);

 let res: Result<QueryResponse<Account>, Vec<ErrorResponse>> = client.query("SELECT Id, Name FROM Account".to_string());
 println!("{:?}", res);
}

QueryResponseのシリアライズの関係でライブラリ利用側もserdeのパッケージを使うようになってます。いまのところログイン方式がResource Owner Password Grant（SalesforceではUsername Password Flowって言われてるやつ）しか対応していないです。
Authorization Code Grantあたりも実装予定。

Salesforce World Tour Tokyo 2019のDeveloper Theaterで登壇しました

Thu, 03 Oct 2019 22:30:00 +0000

Salesforce World Tour Tokyo 2019 のDeveloper Theaterで Salesforceのツールの作り方 というタイトルで登壇してきましたー。

資料はこちら

実は 別の言語でApexを動かすアプローチ というのもCFP出してたんですがそちらは通らなかったという裏話もありますｗ

モチベーション

これまで作成してきたSalesforce関連ツールの数はコミュニティの中でも結構上位だと思い、これは私にしか出来無さそうなテーマだと思った
Salesforceは知名度のわりに3rd partyのツールが少ないのでもっとツールを作る人が増えればよいと思った
- もちろんSaaSだから、とか公式ツールがそれなりに充実してるからってのもあるけど、それにしても少ない印象
何の取り柄もないエンジニアがツールを作成する過程でプログラミングを楽しんだり技術力を伸ばせたので、そこらへんを共有するのは面白いと思った

内容

Salesforceのツールの作り方 というよりは ツール作っていこうぜ！ なエモい内容。

この辺を話したかった↓

目の前の課題に向き合うこと
当たり前を疑ってアイデアを具現化していくこと
プログラミングを楽しむこと

ってか過去の自分に伝えたかったことって感じかな。

思ったこと

登壇や資料整理の過程で、「あー俺はこういう観点でSalesforceのツールを作っていたのだなー」ってのが改めて整理できた。

前職でSalesforceを使ったSIをやってたんだけど、現職ではSalesforceを全く触っていないし、今後もSalesforceをメインの軸としてエンジニアリングしていく予定・希望は無い。

ただ、前職のときよりも今の方がプライベートで作っているSalesforceのツールの数は多くて、傍から見たら「Salesforce好きなんでしょ？」みたいに思われていて、それはちょっと違うなと毎回否定していたりするｗ

じゃあなんで私がSalesforceのツールを作成しているのかっていうと、SalesforceのAPIが充実していて、データストアもあって、何か技術を試すためのBaaSとしては最適だから というのが答えなのかな、と思った（補足: プロダクトの立ち位置的にはSaaS/PaaSだけど私の用途としてはBaaSなのです）

例えば新しいフロントエンドのフレームワークを試したいとき、大体の人がTODOアプリを作っていると思うけど、そのTODOアプリが私にとってはSalesforce関連ツールだったりする。 SalesforceはAPIがかなり充実しているので、何も考えなくてもサーバが用意されているしAPIも用意されている。OIDCやOAuth2.0も完備されているのでユーザ認証を含めたフローの実装もできるし、firebaseのようにカスタムなAPIも実装できる。

そういう意味で私にとって新しい技術を試すためのバックエンドサービスがSalesforceになっている。

今回発表した内容で 作りながら学ぶ、学ぶために作る ということを話したんだけど、わりとそのモチベーションで作っているっていうのが現状で、どうせ作るなら面白いツール・自分のモチベーションが上がるツールを作りたいよね、ということで Apex on Local や AltApex にチャレンジしたという経緯がある。

Salesforceで技術は学べるのかという記事を2年前くらいに書いたけど、日常的にSalesforceに触っていない今でもSalesforceは自分の技術力を上げるきっかけを作ってくれている。

streamWrapperを使ってphp://inputをモックする

Sun, 29 Sep 2019 22:30:00 +0000

PHPでrequestBodyがapplication/www-xxx以外のリクエスト（JSONとかXML）を処理する場合、 php://input からデータを取得することになります。

昨今のフレームワークであればリクエストに関するデータらはRequestオブジェクトなどに隠蔽されており、functional tests等でモックできるため php://input を意識することはほとんど無いと思います。

ただ、フレームワークを使わない場合は php://input を直接ハンドリングする必要があるのですが、その場合functional testsでは php://input のモックをする必要があります。

ということで今回は php://input をstreamWrapperでモックしてphpunitでテストする方法について紹介します。

以下のようなstreamWrapperなクラスを作ります。

<?php

class PHPStreamWrapper
{
 private static $content;
 private $position;

 /**
 * @param string $content
 */
 public static function setContent($content)
 {
 self::$content = $content;
 }

 public function stream_open($path)
 {
 return true;
 }

 public function stream_read($count)
 {
 $ret = substr(self::$content, $this->position, $count);
 $this->position += strlen($ret);
 return $ret;
 }

 public function stream_stat()
 {
 return [];
 }

 public function stream_eof()
 {
 return $this->position >= strlen(self::$content);
 }
}

setContentはモックする文字列をセットする関数で、それ以外はphp://inputからの読み込みで使う関数になります。基本的にはsetContentでセットした文字列をstream_readで返していくだけ。

あとはsetUpでstream_wrapper_registerして、tearDownでstream_wrapper_restoreして元のストリーム処理に戻せばOK。

<?php

class HogeTest extends PHPUnit\Framework\TestCase
{
 public function setUp()
 {
 stream_wrapper_unregister('php');
 stream_wrapper_register('php', PHPStreamWrapper::class);
 }

 public function tearDown()
 {
 stream_wrapper_restore('php');
 }

 public function xxx()
 {
 PHPStreamWrapper::setContent('mock string');
 // 何かテスト
 }
}

仮想DOMを使ったなんちゃってReact/Reduxなフレームワークを作ってみた

Sun, 29 Sep 2019 22:30:00 +0000

React/Reduxの仕組みを知るために仮想DOMを使ったなんちゃってフレームワークを作ってみました。

tzmfreedom/myvirtualdom

今回はその備忘録。

Reactに関しては

自作フレームワークをつくって学ぶ仮想DOM実践入門 | Black Everyday Company

Reduxに関しては

【React.js】createStoreを実装してみたらReduxの理解が捗った - Qiita

の記事を参考にしました。

完成するとこんな感じで書けるようになります。

class App extends Base {
 onMounted() {
 this.state = {
 text: 0,
 records: ['hoge', 'fuga'],
 }
 fetch('https://httpbin.org/get').then((res) => {
 this.setState({
 text: res.statusText,
 });
 this.context.manager.scheduleRender();
 })
 }

 onChangeText(e) {
 this.setState({
 text: e.target.value
 });
 this.dispatch(changeMessage(e.target.value));
 }

 onClickButton() {
 this.state.records.push(this.state.text);
 this.setState({
 records: this.state.records,
 })
 }

 render() {
 return `<div>
 <if c="this.state.text.length === 0">
 <p>blank</p>
 </if>
 <if c="this.state.text.length !== 0">
 <p>{this.state.text}</p>
 </if>
 <ul>
 <for records="{this.state.records}" var="record">
 <li>{variables.record}</li>
 </for>
 </ul>
 <p>{this.getStoreState().message + '!!'}</p>
 <input type="text" value="{this.state.text}" oninput="{this.onChangeText.bind(this)}"/>
 <input type="button" value="Add" onclick="{this.onClickButton.bind(this)}"/>
 <Foo text="{this.state.text}"/>
</div>`
 }
}

class Foo extends Base {
 render() {
 return `<div>{this.props.text}</div>`;
 }
}

const manager = new AppManager('#app', new App({}, {}));
manager.render();

なんちゃってReact

最初のレンダリング時にはセレクタをコンポーネントのクラスを指定し、AppManagerはコンポーネントクラスを使ってDOMを構築してセレクタの要素に対して appendChild します。

streamWrapperを使ってPHPの任意の関数をモックする

Wed, 12 Jun 2019 22:30:00 +0000

PHPではstreamWrapperを使って特定のプロトコルに対するファイル入出力をフックすることができます。

これを使ってcurl関数をモックしたものがphp-vcrで技術的な詳細は以下の記事に書いてあります。

PHP-VCR が curl 関数を乗っ取る方法 | NEW GAME @kunit

任意の関数をモックしてみる

今回はこのstreamWrapperを使ってmail関数をモックしてみようと思います。

streamWrapperは特定の関数を持つクラスになります。インターフェースをimplementsとかではなくダックタイプ的な感じで関数を定義していきます。

<?php

class MailMockStreamWrapper
{
 private $content;
 private $position;
 
 private function register()
 {
 stream_wrapper_unregister("file");
 stream_wrapper_register("file", __CLASS__);
 }

 public function stream_open($path)
 {
 stream_wrapper_restore("file");
 $content = file_get_contents($path);
 $this->content = str_replace("mail", "MailMock::mail", $content);
 $this->register();
 return true;
 }

 public function stream_read($count)
 {
 $ret = substr($this->content, $this->position, $count);
 $this->position += strlen($ret);
 return $ret;
 }

 public function stream_stat()
 {
 return [];
 }

 public function stream_eof()
 {
 return $this->position >= strlen($this->content);
 }
}

stream_openでファイルをすべて読みこんでstream_readで文字列の変数から中身を取り出す、という感じにしています。（一般的にはopenではファイルをオープンするだけでreadのタイミングで読み込むのが良いと思います）

ファイルを読み込む直前でstream_wrapper_restoreしておかないとfile_get_contentsで再度stream_openが呼ばれ、無限再帰するため最初にrestoreで止めておく必要があります。

あとはモックするクラス・メソッドを適当に定義してstream_wrapper_unregister, registerします。

class MailMock
{
 public static function mail($to, $subject)
 {
 echo "to => $to, subject => $subject";
 }
}

stream_wrapper_unregister("file");
stream_wrapper_register("file", "MailMockStreamWrapper");

この状態で適当なコードをrequireすると、requireしたファイルのmail関数がMailMock::mailに置換されて実行されます。

Pimpleコードリーディング

Tue, 11 Jun 2019 22:30:00 +0000

Pimpleのコードリーディングをしました。バージョンは3.2.3です。

このケースで追ってみます

<?php

require_once 'vendor/autoload.php';

use Pimple\Container;

$container = new Container();
$container['session'] = function ($c) {
 return new Session();
};
var_dump($container['session']); // eval
$container['session'] = $container->factory(function ($c) {
 return new Session();
});

コードリーディング

Containerクラス内ではいくつかのインスタンス変数が管理されています。

class Container implements \ArrayAccess
{
 private $values = array();
 private $factories;
 private $protected;
 private $frozen = array();
 private $raw = array();
 private $keys = array();

 public function __construct(array $values = array())
 {
 $this->factories = new \SplObjectStorage();
 $this->protected = new \SplObjectStorage();

 foreach ($values as $key => $value) {
 $this->offsetSet($key, $value);
 }
 }

\ArrayAccessをimplementsしてあるのでこれによって添字アクセスなどが可能になっています。

#offsetSetではvaluesやkeysに値をセットしています。keysの値はtrueがセットされJavaでいうSetのような感じで扱われています。

 public function offsetSet($id, $value)
 {
 if (isset($this->frozen[$id])) {
 throw new FrozenServiceException($id);
 }

 $this->values[$id] = $value;
 $this->keys[$id] = true;
 }

#offsetGetは以下のように定義されています。初回呼び出し時でClosureをセットしている場合は早期returnされず、$raw($this)でClosureが評価されて評価された値がvaluesに再度セットされます。さらに、rawにClosure本体がセットされるので、factoryでセットしていなければ二回目以降の呼び出しは最初に生成したインスタンスがそのまま利用されることになります。

 public function offsetGet($id)
 {
 if (!isset($this->keys[$id])) {
 throw new UnknownIdentifierException($id);
 }

 if (
 isset($this->raw[$id])
 || !\is_object($this->values[$id])
 || isset($this->protected[$this->values[$id]])
 || !\method_exists($this->values[$id], '__invoke')
 ) {
 return $this->values[$id];
 }

 if (isset($this->factories[$this->values[$id]])) {
 return $this->values[$id]($this);
 }

 $raw = $this->values[$id];
 $val = $this->values[$id] = $raw($this);
 $this->raw[$id] = $raw;

 $this->frozen[$id] = true;

 return $val;
 }

factoryでセットしている場合はfactoriesというSplObjectStorageのオブジェクトにClosureがattachされます。

phpdotenvコードリーディング

Mon, 10 Jun 2019 22:30:00 +0000

phpdotenvのコードリーディングをしました。バージョンは3.3.3です。

このケースで追ってみます

<?php

require 'vendor/autoload.php'
$dotenv = Dotenv\Dotenv::create(__DIR__);
$dotenv->load();

echo getenv('FOO');
echo $_ENV('BAR');
echo $_SERVER('BAZ');

コードリーディング

Dotenv\Dotenv::createは以下のようにLoaderのインスタンスを生成し、それを引数にDotenv\Dotenvオブジェクトを生成して返します。

class Dotenv
{
 public static function create($paths, $file = null, FactoryInterface $envFactory = null)
 {
 $loader = new Loader(
 self::getFilePaths((array) $paths, $file ?: '.env'),
 $envFactory ?: new DotenvFactory(),
 true
 );
 return new self($loader);
 }

Dotenv\Dotenv#loadはDotenv\Loader#setImmutatableしたLoaderインスタンスの#loadをコールします。

class Dotenv
{
 public function load()
 {
 return $this->loadData();
 }
 
 protected function loadData($overload = false)
 {
 return $this->loader->setImmutable(!$overload)->load();
 }

LoaderのsetImmutableは以下のような実装になっていて、envVariablesにDotenv\DotenvFactory#createImmutableで生成したDotenv\DotenvVariablesオブジェクトをセットします。

class Loader
{
 public function setImmutable($immutable = false)
 {
 $this->envVariables = $immutable
 ? $this->envFactory->createImmutable()
 : $this->envFactory->create();
 return $this;
 }

Loader#loadはパス上のenvファイルをfile_get_contentsで読み込み、Lines::processで環境変数を書き込んだ各行をstringのArrayにして返します。

class Loader
{
 public function load()
 {
 return $this->loadDirect(
 self::findAndRead($this->filePaths)
 );
 }
 
 public function loadDirect($content)
 {
 return $this->processEntries(
 Lines::process(preg_split("/(\r\n|\n|\r)/", $content))
 );
 }

 private static function findAndRead(array $filePaths)
 {
 if ($filePaths === []) {
 throw new InvalidPathException('At least one environment file path must be provided.');
 }
 foreach ($filePaths as $filePath) {
 $lines = self::readFromFile($filePath);
 if ($lines->isDefined()) {
 return $lines->get();
 }
 }
 throw new InvalidPathException(
 sprintf('Unable to read any of the environment file(s) at [%s].', implode(', ', $filePaths))
 );
 }

processEntriesでは各行（エントリ）をDotenv\Parser::parseでパースしてキーバリューに分解してLoader#setEnvironmentVariableで環境変数にセットします。

PHPのテンプレートエンジンを自作してみた

Sun, 09 Jun 2019 22:30:00 +0000

PHPのテンプレートエンジンを作ってみましたー。
symfony/templatingとか読んでたら急に作りたくなったｗ

tzmfreedom/php-mytemplate-engine

インストール

Packagistに登録していないのでGitHubのrepositoryを設定してよしなにインストールします

$ composer config repositories.tzmfreedom/php-mytemplate-engine vcs https://github.com/tzmfreedom/php-mytemplate-engine
$ composer require tzmfreedom/php-mytemplate-engine:dev-master

使い方

Twigとかsymfony/templatingのPHPEngineとかと同じ使い方です。というかインターフェースを合わせました。

<?php

require_once 'vendor/autoload.php';

$engine = new \MyTemplate\Engine();
echo $engine->render("sample.my", ['xxx' => 'yyy']);

第一引数にテンプレートファイルのパス、第二引数にパラメータのarrayを入れます。

テンプレートファイルはこんな感じで書けます。

<html>
<body>
<div>{{ name }}</div>
<ul>
{{ for item : items }}
<li>{{ item.name }}</li>
{{ end }}
</ul>
{{ if display }}
<p>foo</p>
{{ else }}
<p>bar</p>
{{ end }}
</body>
</html>

実装方法

基本的にASTいじりで、Lexerでトークナイズしてパーサーでツリー作ってVisitorパターンでevaluateしてPHPファイルを生成します。 Lexer, Parserは手書きです。

上のテンプレートファイルだとこういうPHPファイルになります。

<?php

echo <<<EOS
<html>
<body>
<div>
EOS;

echo $name;
echo <<<EOS
</div>
<ul>
EOS;

foreach ($items as $item) {
echo <<<EOS
<li>
EOS;
echo $item->getName();echo <<<EOS
</li>
EOS;

}
echo <<<EOS
</ul>
EOS;

if ($display) {
echo <<<EOS
<p>foo</p>
EOS;

} else {
echo <<<EOS
<p>bar</p>
EOS;

}
echo <<<EOS
</body>
</html>
EOS;

所感

どういう仕組みでテンプレートエンジンが動いているのかを実際に実装することで体験できたのは良かったです。
ASTの評価プロセスは、基本的には文字列を出力するだけなので言語作るよりかは楽だったｗ

KotlinでApexを記述できるAltApexを作っている話

Thu, 06 Jun 2019 22:30:00 +0000

KotlinでApexを記述できるAltApexというのを作っています。

AltApex

本記事ではAltApexを作った背景や使い方、現状の機能をざっと説明します。

背景

現在、Salesforceのサーバーサイド言語としてはApexしか対応していません。 ApexはJavaに似た言語になっていますが、名前空間に対応していない、無名関数が無い、型の明示的な記述が必要など書き味が悪く管理もしづらい言語仕様になっています。

AltApexとは

KotlinでApexを記述できるようにするトランスパイラです（JavaScriptに対するTypeScript的な）

ANTLRでKotlinのファイルをパースしてASTを生成
ASTを辿ってApexファイルを出力

というように処理をして動いています。

インストール

今のところバイナリを配布していないのでgo getしてください。

$ go get -u github.com/tzmfreedom/alt-apex

使い方

Kotlinのファイルを指定すると標準出力にファイルの内容が出力されます

$ alt-apex {file}

対応状況

Kotlinの文法対応状況ですが、現時点では以下のファイルが通るようになっています。

package hoge.foo

class User(private val name: String) {
 private var age:Int = 0
 constructor(name:String, age:Int) : this(name) {
 this.hoge.fuga.age = age
 }

 fun hoge() {
 var i:Int = 0
 if (i == 1) {
 System.debug("hoge")
 } else {
 System.debug(true)
 }

 var hoge:String = if (i == 1) {
 "hello"
 } else {
 "world"
 }

 for (number in numbers) {
 System.debug(number)
 }

 while (i == 1) {
 System.debug(1)
 }

 var i:Int = when (i) {
 1 -> {
 Hoge.fuga("hoge")
 }
 else -> {
 Hoge.fuga("else")
 }
 }
 val pr:PageReference = PageReference()
 var pr:Database.Hoge = Database.Hoge()
 var pr:Int = System.debug(123)
 var pr:Database.Hoge.Fuga = Database.Hoge.Fuga()
 var pr:Hoge = fuga()
 val sum = { x: Int, y:Int -> x + y }
 System.debug(sum(1, 2));
 }
}

Apexにトランスパイルされるとこんな感じ

Salesforce上で別言語を動かす試み

Thu, 09 May 2019 07:30:00 +0000

Salesforce上でApexではないサーバーサイドなオレオレ言語を動かしてみます。

成果物はこちら

tzmfreedom/mini-parser

実装方法

Apexは文字列操作や制御構文などパースに必要な機能は一通り揃っているので、一般的なパーサを実装してASTを使って処理を実行していけばオレオレ言語を実装可能です。バイナリ操作のメソッドが充実しておらずバイトコード的な実装は厳しいため、逐次コード文字列を読み取ってインタープリター的に実行するアプローチを取りました。

一般的なパーサ実装はこんな感じです↓

トークナイズ
パースしてAST生成
ASTを使ってコードを実行

実装言語の仕様

こんな感じな構文を動かせるようにします

# 動的に変数定義可能
a = 123 

# 関数呼び出し
puts "hello" 

# for文
for i = 0; i < 10; i = i + 1 {
 puts i
}

# while文
i = 0
while i < 3 {
 puts i
 i = i + 1
}

# if文

if a == 123 {
 puts "a"
} else {
 puts "b"
}

トークナイズ（Lexer実装）

こんな感じで実装できます

public class Lexer {
 public String str;
 public Integer index;

 public List<String> reserved = new List<String>{
 'if',
 'else',
 'for',
 'while',
 'true',
 'false'
 };

 public Lexer(String str) {
 this.str = str;
 this.index = 0;
 }

 public List<Token> parse() {
 List<Token> tokens = new List<Token>();
 String current = this.current();
 while (true){
 Token token;
 switch on current {
 when '+', '-', '*', '/', '=', '\n', '(', ')', '{', '}', '!', ';', '>', '<' {
 if (current == '=' || current == '!' || current == '<' || current == '>') {
 if (this.peek() == '=') {
 String type = current + this.peek();
 token = new Token(type, type);
 this.next();
 }
 }
 if (token == null) {
 token = new Token(current, current);
 }
 }
 when else {
 if (Pattern.matches('[0-9]', current)) {
 token = this.parseInt();
 } else if (Pattern.matches('[a-zA-Z]', current)) {
 token = this.parseIdent();
 }
 }
 }
 if (token != null) {
 tokens.add(token);
 }
 if (this.index == this.str.length() - 1) {
 break;
 }
 current = this.next();
 }
 return tokens;
 }

 public String peek() {
 return this.str.substring(this.index+1, this.index+2);
 }

 public String current() {
 return this.str.substring(this.index, this.index+1);
 }

 public String next() {
 this.index++;
 return this.current();
 }
 // ...

受け取った文字列を１文字ずつ見ていってトークンの配列を生成します。（Lexerを書いたことない人が見ると難しそうに見えたりしますが、ここは見た目ほど複雑じゃないただただ泥臭いコードです）

HaskellでインメモリなTODO APIアプリを作る

Fri, 12 Apr 2019 00:16:37 +0000

Haskellの練習がてらインメモリDBなTODO APIアプリを作ってみましたー

haskell-sample/Main.hs

全体的にはこんな感じです

ベースの部分はWaiとWarpを利用
ルーティングなどは自作（正規表現とか使わずパーサコンビネータで実装）
データはメモリ上に保持（IORef）
CRUDなAPI

あんまりHaskellでTODOアプリ作っている記事が見当たらなかったので、今回は備忘録も兼ねてどうやって作ったかを書いていきます。

アプリサーバを起動する

waiとwarpを使ってWebサーバを起動します。run関数でアプリサーバを起動できます

main :: IO ()
main = do
 tasks <- defaultTasks
 run 8080 (server tasks)

defaultTasksはデフォルトのDB情報（タスク）が入ったIORefを返します

defaultTasks :: IO (IORef DB)
defaultTasks = newIORef $ DB{
 dbRecords = fromList [
 (1, Task{taskId = 1, taskTitle="foo", taskDescription="bar"}),
 (2, Task{taskId = 2, taskTitle="hoge", taskDescription="fuga"})
 ],
 dbNextTaskId = 3
 }

dbNextTaskIdには自動採番するための次のシーケンス番号、dbRecordsにはタスクレコードがData.Map型で入ってます。

これをリクエストハンドラとなる関数に渡すことでリクエスト間で状態を保持できます。

runの第三引数がリクエストハンドラにあたる部分で、型はApplicationになります。Applicationは Request -> (Response -> IO ResponseReceived) -> IO ResponseReceived の型シノニムで、リクエストを受け取ってレスポンスを生成してそれを(Response -> IO ResponseReceived) の関数に食わせて IO ResponseReceived を返します。

ルーティング

parsecでルーティングを書いています。

まずリクエスト（パスやメソッド）に応じてルーティングを変えていく必要があるので、リクエストを引数として Parser Handler を生成します。 HandlerはRequest -> IORef DB -> IO Responseの型シノニムです。

getHandler :: Handler
getHandler req = case parse (parseRoute req) "" (CBS.decode $ BS.unpack path) of
 Left err -> error $ "ParserError"
 Right ls -> ls req
 where path = rawPathInfo req

ルーティングとしては以下を想定しています

自作gitを作ってみた

Sun, 07 Apr 2019 22:30:00 +0000

車輪の再発明シリーズ、今回は自作gitを作ってみましたー

tzmfreedom/mygit

gitの仕組みは公式に載っているのを参考にして実装しました

Git - Gitオブジェクト

あとこちらの記事もとても詳しいです

Git の仕組み (1) - こせきの技術日記

勉強目的なので、gitの仕様を完全に踏襲する感じではなくざっくり模倣しました。

実装内容

だいたいこんなことをやってます↓

mygit init で .mygit ディレクトリを作成。中身はこんな感じ↓
- index ファイル（ステージ用）
- refs ディレクトリ（ブランチのreferenceを格納）
- objects ディレクトリ（blobやらtreeやらcommitを格納）
mygit add で .mygit/index にファイル情報をメモしつつ、.mygit/objects/{ファイルの中身のSHA1ハッシュ} にファイルの中身を格納
mygit commit で .mygit/index のファイルをコミット
- .mygit/objects/{commitハッシュ} にコミットのオブジェクトを作成
- 新規ディレクトリが含まれている場合はtreeオブジェクトも作成
- 既存tree内のオブジェクトの変更があればハッシュ値を更新（親treeに伝搬する）
- .mygit/index をクリア
- .mygit/refs/heads/master を最新のコミットに書き換え
mygit tree {commitハッシュ} で対象コミットのファイルをツリー表示
mygit diff {commitハッシュ} {commitハッシュ}　で対象コミット間のdiffを表示
mygit log でコミットログを簡易的に表示
mygit status で .mygit/index の中身を良い感じに表示
mygit cat-file {ハッシュ} で .mygit/objects/{ハッシュ} の中身を良い感じに表示

commitのファイル仕様

commit
{treeハッシュ}
{前のcommitハッシュ}
{author}
{message}

treeのファイル仕様

ブログをWordpressからNetlifyに移行しました

Sun, 31 Mar 2019 22:30:00 +0000

ブログをWordpressからNetlifyに引っ越しましたー

移行した理由

旧ホスティング先のサーバのPHPのバージョンが古く、自身がアップグレードするモチベーションも湧かなかった
静的ファイルでそんなに凝ったことしてないのにWordpress使っててtoo match感（そして遅い）
記事編集で保存や新規記事画面への遷移も遅かった（かといってスケールアップする気にもならない）
Wordpressのgutenbergが結構厳しくて、以前はプラグインの旧エディタ使っていたけど、旧エディタもMarkdownより書きづらいなーと思うことが増えてきた
Wordpressのプラグインとか色々入れてて管理できてないし管理するモチベーションが（ｒｙ
もっとシンプルにしてブログ自体を技術的な実験ができる場にしたい

と色々あったのです…。

変わったところ

Before
- Wordpress
- VPS (DTIの月額500円プラン)でホスティング
- エッジはCloudFront
- オリジンはH2O + php-fpm
After
- 静的ファイル置くだけ
  - その静的ファイルは自前のブログジェネレータで生成
- Netlifyでホスティング
- instantclick.ioで別記事への遷移を爆速にした（やりたかった実験その１）

移行手順

Wordpressから記事データのXMLをエクスポート
- 記事データのXMLから記事のデータを抽出
Wordpressから画像データをエクスポート
記事をごにょごにょ
- 画像のリンク先が /wp-content/uploads/... とかってなってるのを一括置換
- コードのタグを調整(<pre class="lang:ruby ...> => ```ruby)
- などなど
自前ジェネレータでmarkdownからhtml変換
Netlifyにデプロイ（githubにpushして自動デプロイしたり手元からcliツールで手動デプロイしたり）

記事をごにょごにょするのは結構トライアンドエラーな感じだったのでRubyでちょろっとスクリプトを書きました。

こんな感じ↓

#!/usr/bin/env ruby

require 'nokogiri'
require 'date'

filename = ARGV[0]

doc = Nokogiri::XML(File.open(filename)) do |config|
 config.options |= Nokogiri::XML::ParseOptions::HUGE
end

doc.css('item').each do |node|
 begin
 title = node.xpath("title")[0].inner_text.strip.gsub('"') { '\"' }
 postname = node.xpath("wp:post_name")[0].inner_text.strip
 content = node.xpath("content:encoded")[0].inner_text.strip
 content.gsub!('&#034;') { '"' }
 content.gsub!('&#039;') { "'" }
 content.gsub!('&quot;') { '"' }
 content.gsub!('&gt;') { ">" }
 content.gsub!('&lt;') { "<" }
 content.gsub!('&amp;') { "&" }
 content.gsub!(/<pre class="lang:default\s+[a-zA-Z:\s-]*">/) { "\n```\n" }
 content.gsub!(/<pre class="lang:language\-default\s+[a-zA-Z:\s-]*">/) { "\n```\n" }
 content.gsub!(/<pre class="lang:language\-([a-zA-Z]+)\s+[a-zA-Z:\s-]*">/) { "\n```#{$1}\n" }
 content.gsub!(/<pre class="lang:(.+)\s+[a-zA-Z:\s-]*">/) { "\n```#{$1}\n" }
 content.gsub!('```sh') { '```bash' }
 content.gsub!(/\n*<\/pre>/) { "\n```" }
...

自前のジェネレータはこれです。ジェネレータといってもやっていることはこれくらい

Hackageに自作ライブラリを登録するまでのメモ

Fri, 08 Mar 2019 07:30:40 +0000

Hackageに登録するまでの手順をざっくりメモった

HaskellのSalesforceクライアントを作ってみた

Thu, 07 Mar 2019 07:30:33 +0000

いつもの作ってみたシリーズ。今回はHaskell x Salesforceでございます。

DML文でSalesforceオブジェクトを操作できるsoql-cliを作った

Sat, 05 Jan 2019 07:30:54 +0000

SQLのDML構文でSalesforceのレコードを更新してみたい。ということで作ってみました

tzmfreedom/soql-cli: Salesforce SOQL CLI like mysql, psql command

自作言語をAWS LambdaのCustom Runtimeで動かしてみた

Thu, 03 Jan 2019 09:30:45 +0000

自作言語をAWS LambdaのCustom Runtimeで動かしてみました。

2019

Tue, 01 Jan 2019 00:00:00 +0900

2018年の振り返り

Mon, 31 Dec 2018 07:30:10 +0000

今年はどんな一年だったのか振り返る的な

Land Playgroundのプレゼント

Mon, 24 Dec 2018 07:30:22 +0000

めりーくりすます

https://goland-server.herokuapp.com/

Salesforce環境との接続なしのApexのコードお試し場
コードスニペットのシェアができます。
SOQL、ちょっとだけ使えます（テスト環境と繋がってます）
- ってかAccountのSELECT句はId, Name, Website, Field1__cしか使えないですｗ
class構文は使えません。
ビルトインのクラス・メソッドもほとんど無いのでSystem.debugくらいしかできないですorz
変数定義・代入、if、for、whileくらいは通るはず
エラー文とかまともに出してません。
- レスポンスが返ってこない＝何かしらエラーで落ちてますm(_ _)m
ローカルでも試せます。
- $ goland eval-server
Dreaminまでにはもう少しまともなの作ります。

Xdebug, DBGPで簡易リモートデバッガを作る

Sun, 23 Dec 2018 00:00:07 +0000

Xdebug, DBGPで簡易デバッガを作ってみました。

SimpleDebugger.php

この記事はPHP Advent Calendar 2018の23日目の記事です。

YetでAnotherなSalesforce Dataloaderを作った

Thu, 20 Dec 2018 00:00:41 +0000

ということでデータローダ作りました。Salesforce Dataloaderができる基本的な機能は踏襲しつつYet Another感出してみました。

tzmfreedom/yasd: Yet Another Salesforce Dataloader with golang

あ、この記事は Trailblazer Advent Calendar 2018 第20日目の記事となります。

Bulletコードリーディング

Wed, 19 Dec 2018 00:00:35 +0000

N+1クエリの検出ツールとして有名なBulletのコードリーディングをしました。バージョンは5.9.0です。

コードリーディングの過程で、False Negative, False Positiveなケースを発見したのでそれも併せて紹介します。

※この記事はRuby on Rails Advent Calendar 2018の19日目の記事です。

デバッガのための実行基盤の実装について

Fri, 14 Dec 2018 00:00:06 +0000

この記事は言語実装 Advent Calendar 2018 - Qiitaの14日目の記事です。

Salesforce上で動くプログラミング言語Apexをローカル環境で動かすLANDという実行基盤を作っています。

tzmfreedom/goland: Salesforce Apex Execution Environment on Local System.

LANDを作った契機などはこちらの記事に書いてあります。ちなみにANTLR + Golang製です（最初はRacc/RexというRubyで書けるyacc/lexなツールで書いていたのですがJavaの文法がパースしづらく、ANTLRに切り替えたりと紆余曲折ありましたｗ）

言語実装のアドベントカレンダーとしては少し趣向が変わってきてしまうかもしれませんが、今回はLANDのデバッガの仕組みを紹介しようと思います。

[Salesforce] 真の開発者コンソールを作ってみた

Wed, 05 Dec 2018 00:00:41 +0000

アレなタイトルですがTUIなコンソールアプリを作ってみました。

tzmfreedom/lui: Salesforce Lightning TUI Application

config/initializers/new_framework_xxx.rbが効かなかったときのハマりメモ

Fri, 16 Nov 2018 07:30:55 +0000

Railsアップグレード時に bin/rails app:updateしたときに生成されるconfig/initializers/new_framework_xxx.rbが効かなかったときのハマりメモ。Railsのバージョンは5.1.4です。

Couldn't find template for digestingエラー

Thu, 15 Nov 2018 07:30:58 +0000

Railsで以下のエラーがログに書かれていて、原因を調査したのでその備忘録。バージョンは5.2.1です。

Couldn't find template for digesting: vars/var

ANTLR4でパーサをgolangで作る

Tue, 09 Oct 2018 07:30:28 +0000

ANTLR4のgolangでvisitorパターンで実装するサンプルが無かったので試しに作ってみました。

tzmfreedom/go-salesforce-formula-parser: Parse Salesforce Formula and, Build AST in Golang

以下、golangで実装する場合の備忘録

ecs-deployコードリーディング

Mon, 01 Oct 2018 07:30:21 +0000

ecs-deployのコードリーディングをしました。バージョンは3.4.0です。

env-injectorコードリーディング

Tue, 11 Sep 2018 07:30:03 +0000

env-injectorのコードリーディングをしました。

Salesforce SOAP APIのgolangクライアント作った

Mon, 10 Sep 2018 07:30:49 +0000

なぜ私はSalesforceのツールを作るのか…。ということでgolangのクライアント作りました。

tzmfreedom/go-soapforce: Salesforce SOAP API Client for golang

モチベーションとしてはYet Another Salesforce Dataloaderをgolangで作ろうと思っているんですが、それを作るにはまずSOAPのクライアントで複数件の一括CRUDを実現させなければならない、ということでヤクの毛刈りをした感じです。

RackをバックエンドとするCLIツール Racliを作ってみた

Wed, 29 Aug 2018 07:30:21 +0000

表題のとおり、RackをバックエンドとしたCLIツール Racliを作ってみました。

RailsEventStoreコードリーディング

Tue, 28 Aug 2018 07:30:46 +0000

RailsEventStoreのコードリーディングをしました。バージョンは0.31.1です。

SalesforceのワークフロールールをApexトリガに変換するヤーツ作った

Thu, 16 Aug 2018 07:30:33 +0000

~~Apexをローカル環境で動かすのめっちゃムズイし現実逃避したくなったので~~ SalesforceのワークフロールールをApexトリガに変換するヤーツを作りました。

[Salesforce] Apexのローカル実行環境を作ろうとしている話

Tue, 24 Jul 2018 07:30:25 +0000

ふと思い立ち、SalesforceのApex言語のローカル実行環境を作っています。

tzmfreedom/apex_parser2

まだまだリリースにはほど遠いのですが、単純なコードであればある程度は動く状態になってきているので、モチベーション維持のためにここらで紹介記事を書きたいと思います。

Rodaコードリーディング

Mon, 18 Jun 2018 07:30:29 +0000

Rodaのコードリーディングをしました。バージョンは3.8.0です。

Hanamiコードリーディング【hanami new】

Tue, 12 Jun 2018 07:30:57 +0000

Hanamiのコードリーディングをしました。バージョンは1.2.0です。今回は hanami new のアプリケーションの初期化コマンドのコードを追ってみます

TruffleRubyを動かしてみる

Mon, 11 Jun 2018 07:30:33 +0000

GraalVM上で動く超絶速いTruffleRubyを動かしてみました。

ArgumentError: path name contains null byte

Sun, 10 Jun 2018 17:28:44 +0000

bundle gemしたディレクトリ内でbundle installしようとしたら以下のエラーが発生した

--- ERROR REPORT TEMPLATE -------------------------------------------------------
# Error Report

...

ArgumentError: path name contains null byte

...

Unfortunately, an unexpected error occurred, and Bundler cannot continue.

First, try this link to see if there are any existing issue reports for this error:
https://github.com/bundler/bundler/search?q=path+name+contains+null+byte&type=Issues

If there aren't any reports for this error yet, please create copy and paste the report template above into a new issue. Don't forget to anonymize any private data! The new issue form is located at:
https://github.com/bundler/bundler/issues/new

原因は以下のようにgemspecのspec.filesのsplit("\x0") を本来ダブルクォートで囲うべきなのにシングルクォートで囲ってしまったため。

optcarrotをmacOSで動かす

Tue, 05 Jun 2018 23:00:25 +0000

optcarrotをmacOSで動かすときのちょいメモ

何はともあれSDL2を使うのでインストール

$ tar -xf SDL2-2.0.8.tar.gz
$ cd ./SDL2-2.0.8
$ ./configure
$ make
$ sudo make install

ファミコンをインストール

$ git clone http://github.com/mame/optcarrot.git
$ cd optcarrot
$ bundle install

立ち上げ

$ bundle exec bin/optcarrot --sdl2 --audio=none examples/Lan_Master.nes

ひとりごと (2018/05/15)

Tue, 15 May 2018 23:43:50 +0000

2018/05/15分

ひとりごと (2018/05/13)

Sun, 13 May 2018 21:50:54 +0000

記事紹介

Rails Testing Antipatterns: Models

概要
- Railsのモデルテストのアンチパターン
- build使ってDBに保存せずに高速に
- POROやconcerningで良い感じに分割してDB依存なくして高速に
- let vs let! vs before

Ruby Memoization using Singleton Method

概要
- シングルトンメソッドを使ってMemorization
- 初回ははインスタンスメソッドを呼び出して、そこで def self.xxx でシングルトンメソッドを定義して二回目以降はシングルトンメソッドを呼び出す方法
- ||=のMemorizationだとnilやfalseで再評価されるが、この方法だと再評価されない（シングルトンメソッドの有り無しが初期化しているかどうかの判別になる）
- ||=より速いらしい
コメント
- これは面白い初期化の方法だなー。Rubyの仕様的には問題無さそう。
- インスタンスメソッド経由でシングルトンメソッドを定義するの面白い

Yuki & Moto Press Bookshelf

概要
- Free Books in the Yuki & Moto Press Series
コメント
- 凄い…時間があったらこれも読んでみます

Method Arguments in Ruby: Part I

概要
- メソッドの定義と呼び出し方について

Private & Protected: a matter of Message

概要
- private, protectedについて

Ruby Object Model - Part 1

概要
- Object, mainオブジェクトなどのRuby Objectに関して
コメント
- Rubyを学び始めたとき、mainがトップレベルのコンテキストであることを知って面白いなーと思った。こういうオブジェクト指向の一貫性が好き

Put chubby models on a diet with concerns

概要
- 2012年の記事
- concern使って、ドメインモデルを考慮して良い感じにモデルをダイエットしていこう

rubyref.net

概要
- Rubyのドキュメントに関するリファレンス一覧
コメント
- こんなのあったんだなー。便利

ひとりごと (2018/05/11)

Fri, 11 May 2018 23:51:07 +0000

技術記事やgemの紹介をデイリーでやっていく試み（つぶやきの延長です）

ひとりごと (2018/05/10)

Thu, 10 May 2018 23:53:10 +0000

技術記事やgemの紹介をデイリーでやっていく試み（つぶやきの延長です）

RubyGemsのinstallは何をやっているか

Thu, 10 May 2018 07:30:39 +0000

RubyGemsのコードリーディングをしました。バージョンは2.7.3です。今回は gem installのパターンで追ってみます。

ひとりごと (2018/05/09)

Wed, 09 May 2018 22:40:45 +0000

技術記事やgemの紹介をデイリーでやっていく試み（つぶやきの延長です）

RubyGemsのrequireは何をやっているか

Wed, 09 May 2018 07:30:00 +0000

＝gemspecのスタブの中で対象のファイルが存在すれば、それを返します。 def self.find_by_path path path = path.dup.freeze spec = @@spec_with_requirable_file[path] ||= (stubs.find { |s| next unless Gem::BundlerVersionFinder.compatible?(s) s.contains_requirable_file? path } || NOT_FOUND) spec.to_spec end

stubsはspecificationsディレクトリ内にある拡張子がgemspecのもの（＝インストール済みのrubygemのgemspec）を検索してGem::StubSpecificationのインスタンスを返します。 def self.stubs @@stubs ||= begin pattern = “*.gemspec” stubs = default_stubs(pattern).concat installed_stubs(dirs, pattern) stubs = uniq_by(stubs) { |stub| stub.full_name }

 _resort!(stubs)
 @@stubs_by_name = stubs.group_by(:name)
 stubs
end

end

default_stubsはspecifications/defaultのディレクトリ内にあるgemspecを拾ってStubSpecificationのインスタンスを生成します。defaultディレクトリには csv やjsonなどの標準ライブラリが入っています。 def self.default_stubs pattern base_dir = Gem.default_dir gems_dir = File.join base_dir, “gems” gemspec_stubs_in(default_specifications_dir, pattern) do |path| Gem::StubSpecification.default_gemspec_stub(path, base_dir, gems_dir) end end

Railsのミドルウェアのエラーハンドリング

Tue, 03 Apr 2018 07:30:35 +0000

RoutingErrorやRack::QueryParser::InvalidParameterErrorが発生した場合にはRackミドルウェアベースでエラーハンドリングされます。今回はこのエラーハンドリングの処理についてコードリーディングしていきます。Railsのバージョンは5.1.5です。

did_you_meanコードリーディング

Mon, 02 Apr 2018 07:30:04 +0000

did_you_mean(1.2.0)のコードリーディングをしました。

bootsnapコードリーディング（load_iseqを使った高速読み込み）

Thu, 29 Mar 2018 07:30:00 +0000

bootsnap(1.2.0)のコードリーディングをしました。今回はload_iseqによるrequire, loadの高速化を見ていきます。

simplecovコードリーディング

Wed, 28 Mar 2018 07:30:52 +0000

simplecov (0.16.1)のコードリーディングをしました。

bootsnapコードリーディング（requireのパス検索の高速化）

Tue, 27 Mar 2018 07:30:17 +0000

require, loadの高速化を行うbootsnap(1.2.0)のコードリーディングをしました。今回はrequireのパス検索の高速化部分を読んでいきます。

yomikomuコードリーディング

Mon, 26 Mar 2018 07:30:09 +0000

yomikomu(0.4.1)のコードリーディングをしました。

byebugがdebase(ruby-debug-ide)と同時に使えるようになった

Sat, 24 Mar 2018 07:30:10 +0000

byebug 10.0.1でdebaseと同時に使えるようになったのでその紹介記事です。

pumaの再起動時のディレクトリについて

Fri, 23 Mar 2018 07:30:36 +0000

capistranoでデプロイをしてもRailsアプリのコードが反映されない！とハマったので備忘録

binding_of_callerコードリーディング

Thu, 22 Mar 2018 07:30:36 +0000

binding_of_caller (v0.8.0)のコードリーディングをしました。Rubyのバージョンは2系以上のものを扱っていきます。

rb-inotifyコードリーディング

Tue, 20 Mar 2018 07:30:57 +0000

rb-inotify (0.9.10)のコードリーディングをしました。listenで利用されているgemです。

byebugコードリーディング

Mon, 19 Mar 2018 07:30:03 +0000

byebug(10.0.0)のコードリーディングをしました。

Railsアセットパイプラインのコードリーディング

Fri, 16 Mar 2018 07:30:38 +0000

Railsのアセットパイプライン周りのコードリーディングをしました。今回はassets:precompileのRakeタスクで何をやっているかをコードベースで追っていきます。Railsのバージョンは5.1.5です。

capistrano/sshkitコードリーディング

Thu, 08 Mar 2018 07:30:55 +0000

capistrano (3.10.1)のSSHKitを利用する部分をコードリーディングしてみました。

Rack CORSコードリーディング

Wed, 07 Mar 2018 07:30:52 +0000

rack-cors (1.0.2)のコードリーディングをしました。

tachikomaコードリーディング

Tue, 06 Mar 2018 07:30:32 +0000

tachikoma (5.2.0)のコードリーディングをしました。

Railsのform helper周りのコードリーディング

Mon, 05 Mar 2018 07:30:21 +0000

Railsのform helper周りのコードリーディングをしました。Railsのバージョンは5.1.5です。

compare_linker_wrapperコードリーディング

Fri, 02 Mar 2018 07:30:49 +0000

compare_linker_wraper (v1.0.2)のコードリーディングをしました。

ActiveRecord::NoEnvironmentInSchemaErrorについて

Thu, 01 Mar 2018 07:30:41 +0000

RailsでActiveRecord::NoEnvironmentInSchemaErrorが出たときの原因と対応方法の備忘録。Railsのバージョンは5.1.5です。

DockerでSFTP開発環境を作る

Wed, 28 Feb 2018 07:30:59 +0000

サービス連携の用途でSFTPをプログラムから利用することがあると思いますが、今回はDockerコンテナを使ってSFTP開発環境の作り方を紹介します。

ActiveRecord::PendingMigrationErrorはどうやって発生するのか

Tue, 27 Feb 2018 07:30:03 +0000

開発中のエラーでよく出てくるActiveRecord::PendingMigrationErrorについて調べてみました。Railsのバージョンは5.1.5です。

RailsのCSRF周りのコードリーディング

Mon, 26 Feb 2018 07:30:47 +0000

RailsのCSRF周りのコードリーディングをしました。

Railsのlogger周りのコードリーディング

Fri, 23 Feb 2018 07:30:51 +0000

Railsのlogger周りのコードリーディングをしました。

Railsのsession周りコードリーディング

Thu, 22 Feb 2018 07:30:40 +0000

Railsのsessionがどうやって設定されるのかをコードリーディングをして追ってみました。Railsのバージョンは5.1.4です。

I18nコードリーディング

Wed, 21 Feb 2018 07:30:10 +0000

I18n(0.9.3)のコードリーディングをしました。

seed-fuコードリーディング

Tue, 20 Feb 2018 07:30:10 +0000

seed-fu (2.3.7)のコードリーディングをしました。

bundlerコードリーディング【exec編】

Mon, 19 Feb 2018 07:30:27 +0000

bundler (1.16.1)のコードリーディングをしました。今回は bundle exec のコードを追ってみます。

hirbコードリーディング

Fri, 16 Feb 2018 07:30:49 +0000

hirb (0.7.3)のコードリーディングをしました。

Railsはbin/railsが無いと起動できない

Thu, 15 Feb 2018 07:30:12 +0000

Railsはbin/railsが無いとnew以外のコマンドを実行できません。今回はコードレベルでその理由を追っていこうと思います。railsのバージョンは5.1.4です。

公式のRubyのDockerイメージのbundlerの挙動

Wed, 14 Feb 2018 07:30:46 +0000

少しハマったので備忘録。公式のRubyのDockerイメージを使うとbundler経由でインストールしたものをボリューム用コンテナで永続化しても二回目以降の起動時でうまく反映されない事象が起きました。

annotateコードリーディング

Tue, 13 Feb 2018 07:30:27 +0000

annotate (2.7.2)のコードリーディングをしました。

better_errorsコードリーディング

Wed, 07 Feb 2018 07:30:31 +0000

BetterErrorsのコードリーディングをしました。

Rakeタスクにおけるnamespace内でのメソッド定義

Tue, 06 Feb 2018 07:30:08 +0000

Rakeタスク内でメソッド定義するとObjectのprivateメソッドとして定義されます。なので下のような書き方は一見namespace配下にメソッドを定義しているように見えますがObjectのメソッドとして定義されてしまっています。

def outside_method
 puts 'outside method'
end

namespace :foo do
 def inside_method
 puts 'inside method'
 end

 desc "bar"
 task :bar do
 outside_method # "outside_method"
 inside_method # "inside_method"
 puts method(:outside_method).owner # => Object
 puts method(:inside_method).owner # => Object
 end
end

Rakeは各タスクの定義ファイルをKernel.loadしていて、namespaceはインスタンス変数の@scopeに名前空間を設定しつつ、与えられたブロックを普通にyieldしています↓

module Rake
 module TaskManager
# ...
 def in_namespace(name)
 name ||= generate_name
 @scope = Scope.new(name, @scope)
 ns = NameSpace.new(self, @scope)
 yield(ns)
 ns
 ensure
 @scope = @scope.tail
 end

なので、block内のメソッド定義はnamespace外のメソッド定義と同じです。

同様にCapistranoもRake::Applicationクラスを継承して作られているので、namespace内で記述されたメソッドはObjectのメソッドとして定義されます。

ちなみにrspecのdescribeのブロックは動的に作成されるクラスのmodule_execメソッドの引数として渡されるので、そのクラスのメソッドを定義していることになります。なのでObjectのメソッド定義になりません。

module RSpec
 module Core
 class ExampleGroup
 def self.define_example_group_method(name, metadata={})
 idempotently_define_singleton_method(name) do |*args, &example_group_block|
# ...
 subclass(self, description, args, registration_collection, &example_group_block)
# ...
 end

 RSpec::Core::DSL.expose_example_group_alias(name)
 end

 def self.subclass(parent, description, args, registration_collection, &example_group_block)
 subclass = Class.new(parent)
 subclass.set_it_up(description, args, registration_collection, &example_group_block)
 subclass.module_exec(&example_group_block) if example_group_block

 MemoizedHelpers.define_helpers_on(subclass)

 subclass
 end

Railsプラグイン開発のダミーアプリでrails restart

Thu, 18 Jan 2018 23:52:40 +0000

小ネタ。Railsプラグイン開発で{test, spec}/dummy内のダミーアプリを起動して確認する場合、プラグインのコード変更はダミーアプリが読み込むgemの変更になるので自動的にリロードされず、ダミーアプリを再起動する必要があります。

また、ダミーアプリはpluginとpluginの依存ライブラリを除いてrailsのみrequireしてます。なので、 rails sしてもpumaではなくWEBrickが立ち上がります。

rails restart（あるいはrake restart）はpumaの再起動方法になるので、このコマンドで再起動する場合は以下のようにpluginのGemfileにpumaを追加する必要があります。

source 'https://rubygems.org'

gemspec

gem 'puma'

これで bundle installすればrails sで起動したpumaのアプリサーバを rails restartで再起動できます。

ちなみにこれだけだと毎回コマンド打たなきゃいけないのでそれも面倒です。なのでguardで自動化します。Guardfileはguard-shellを使うとこんな感じで書けます。

guard :shell do
 watch /(app|lib)\/.*/ do |m|
 puts `cd spec/dummy; bundle exec rails restart`
 m[0] + " has changed."
 end
end

これでapp, libディレクトリ内のファイル変更を検知して自動的に rails restartしてくれます。まぁ自動化するんならpuma必須じゃないんですけどね…ｗ

AASMコードリーディング

Thu, 11 Jan 2018 07:30:02 +0000

状態遷移の管理を行うAASMのコードリーディングをしました。バージョンは4.12.3です

wheneverコードリーディング

Sat, 06 Jan 2018 07:30:49 +0000

RubyでDSL書いてcronの設定ができるwheneverのコードリーディングをしました。バージョンは0.10.0です

figaroコードリーディング

Fri, 05 Jan 2018 07:30:09 +0000

設定ファイルから環境変数をセットするfigaroのコードリーディングをしました。バージョンは1.1.1です

2017年の振り返り

Sun, 31 Dec 2017 16:00:00 +0000

2017年を「仕事」「技術」の面で振り返ってみました。

2018

Mon, 01 Jan 2018 00:00:00 +0900

Salesforceで技術は学べるのか？

Thu, 21 Dec 2017 00:00:52 +0000

本記事はSalesforce Platform Advent Calendar 2017の21日目の記事です。

前職ではSalesforce＋α（AWSとかHerokuとか）なSI業務を5年半くらいやっていて、昨年、事業会社のエンジニアとして転職してから1年ちょっとが経過しました。新卒エンジニアとしてのスタートがSalesforceというのは当時としてはレアな経歴だったと思うし、それが故にエンジニアとしての色々な悩みを抱えつつ仕事をしていました。

ということで、本記事では「エンジニアとしてSalesforceで技術は学べるのか？スキルアップできるのか？」とか「潰しが効くのか？」とかそういった疑問に対する考えをダラダラと書いていきたいと思います。

Rails API開発におけるJSONレスポンス生成方法と内部実装について

Tue, 19 Dec 2017 00:00:54 +0000

Ruby on Rails Advent Calendar 2017 19日目の記事です。

RailsでAPI開発するときのJSONレスポンスの生成方法についてまとめてみました。

RubyGemコードリーディングのすすめ

Wed, 13 Dec 2017 00:00:24 +0000

Ruby Advent Calendar 2017 13日目の記事になります。

使っているRubyGemの挙動や仕組みを理解するためによくコードを読んでいるのですが、今回はコードリーディグについて記事を書いていこうと思います。

$ref のJSON Pointerを展開するrubygemを書いた

Mon, 20 Nov 2017 07:30:49 +0000

JSON Schemaで記述される$refパラメータのリンクを展開するrubygemを書きました。

jbuilderより速いRails Viewハンドラーを書いた

Thu, 16 Nov 2017 07:30:04 +0000

YAMLとERBでJSONを書けるハンドラを書いたものの遅くなってしまったので、一旦YAMLとERBのことは忘れ、evalとしては最速になるようにhashをJSONに変換するアプローチで再度書いてみました。

また前回同様、

モンキーパッチをしない
N+1 find_template_pathsを避ける
Railsのcollectionのパーシャルレンダリングの仕組みを使う

というのをコンセプトでやっています。

できあがったものはこれ↓

tzmfreedom/jv

draperコードリーディング

Wed, 15 Nov 2017 07:30:53 +0000

drapergem/draperのコードリーディングの備忘録。

YAMLでJSONを返すRails Viewハンドラーを書いた

Tue, 14 Nov 2017 07:30:14 +0000

実用性皆無の勉強用でRailsのViewハンドラーを書いてみました。YAMLとERBで記述して、JSONを返すハンドラです。

tzmfreedom/yj

RequestStoreコードリーディング

Tue, 14 Nov 2017 00:55:58 +0000

steveklabnik/request_storeのコードリーディング。

rbenvコードリーディング

Mon, 13 Nov 2017 07:30:06 +0000

rbenv/rbenvのコードリーディングの備忘録。バージョンは1.1.0-2-g4f8925a です。

jbuilderで無理矢理N+1 partial renderingを回避する方法

Fri, 10 Nov 2017 07:30:21 +0000

実務では絶対に使わないけどrails/jbuilderのpartialレンダリングを無理矢理早くする方法。

sidekiqコードリーディング

Tue, 07 Nov 2017 07:30:34 +0000

sidekiqのコードを読んだので備忘録。バージョンは5.0.5です

unicornコードリーディング

Mon, 30 Oct 2017 07:30:31 +0000

unicornを読んだので備忘録。非公式ですがミラーのリポジトリは defunkt/unicornです。

WEBrickはシングルスレッドではない

Wed, 25 Oct 2017 07:30:23 +0000

表題の通り、WEBrickはシングルスレッドなアプリサーバではなくマルチスレッドです。

にも関わらず、Web上にはWEBrickがシングルスレッドであるかのような記事が多く、Wikipediaでも

Unlike most of the servers that are used in production, 
WEBrick is not scalable since it is a single threaded web server by default.

と記載があり、とても誤解をまねきやすいです（デフォルトで、と言っているので完全に間違っているとは言い難いけど）

今回は、WEBrickがマルチスレッドサーバである根拠と、なぜシングルスレッドと誤解されているのかをRailsのバージョンの話も交えて書いていきます。

rails/springコードリーディング

Tue, 24 Oct 2017 07:30:00 +0000

rails/springのコードリーディングをしましたー。ということで備忘録。

OmniAuth::LineOpenidConnectを作った話

Thu, 12 Oct 2017 07:30:40 +0000

omniauthでLINEでログインを実装するの記事でOmniAuth::Lineを改変したのですが、そもそもOAuth認証じゃなくてOpenID Connectに対応したのだから、そっちにプラグイン作った方が良いなーと思い、勉強がてら作りました。

WEBrick::HTTPServerコードリーディング

Wed, 11 Oct 2017 07:30:48 +0000

WEBrick::HTTPServerのコードを読んだので備忘録。rackup時の挙動に関しても書きました。

omniauthコードリーディング

Tue, 10 Oct 2017 07:30:35 +0000

omniauthのコードリーディングをしてみたので備忘録。

omniauthでLINEでログインを実装する

Tue, 10 Oct 2017 00:03:37 +0000

kazasiki/omniauth-lineを使ってLINEでログインを実装しようと思ったものの、新しいバージョンに対応していなかったのでforkして改変してみました（本家にプルリク中）

~~tzmfreedom/omniauth-line~~

マージいただきました！ありがとうございます！！ということでLINE IDでログインしたい場合は、omniauth-lineのgemをそのままお使いください！

omniauthの設定はREADMEに書かれている通り、こんな感じで指定するだけ。

Rails.application.config.middleware.use OmniAuth::Builder do
 provider :line, "Channel_ID", "Channel_Secret"
end

callbackパスは/auth/line/callbackになるのでよしなにログインするなりプロビジョニングするなりすればOKです。

5分で試すRackミドルウェア

Thu, 05 Oct 2017 07:30:14 +0000

5分でRailsでRackミドルウェアを試した備忘録。

FormクラスでラップしたActiveRecordのエラー内容をマージする

Wed, 04 Oct 2017 07:30:52 +0000

Formオブジェクトを使って、ActiveRecord経由でDBにレコードを保存する場合、エラー内容を適切にマージする必要があるよーということの備忘録。

RubyのModule#const_getについて調べてみた

Fri, 08 Sep 2017 07:30:52 +0000

Module#const_getはそのモジュール内に定義されている定数を取得することができるメソッドです。動的にインスタンスを生成したり、定数を参照するときに利用しますが、今回はModule#const_getのハマりポイントを紹介します。

ansibleを使ってCentOS 6にmysql5.6をインストール

Mon, 21 Aug 2017 07:30:07 +0000

ansibleを使ってCentOS 6にmysql5.6をインストールする方法についての備忘録。

CentOS 6のデフォルトのリポジトリだとmysql5.1がインストールされるので、それ以上のバージョンをインストールする場合は、公式レポジトリからrpmを取ってきてインストールする必要があります。そこらへんの処理をansibleで書いて自動プロビジョニングできるようにしました。

RailtieでControllerを拡張する

Mon, 07 Aug 2017 07:30:17 +0000

勉強がてら、Controllerを拡張するRailtieを作ってみたので備忘録。基本的な作り方はこちらの記事と記事内の参考URLを参考にすると良いです。

Railtieのinitializerが読み込まれる仕組み

Fri, 04 Aug 2017 07:30:50 +0000

Railtieのサブクラスで呼び出したinitializerブロックが読み込まれる仕組みをコードを読んで紐解いてみました。Railsは5.1.2です

ActiveSupport.on_loadとrun_load_hooksのコードリーディング

Thu, 03 Aug 2017 07:30:28 +0000

ActiveSupport.onload と ActiveSupport.run_load_hooks のコードを読んでみました。

RailtieでActionMailerを拡張する

Wed, 02 Aug 2017 07:30:37 +0000

Railtieを使ってActionMailerのdelivery_methodを拡張してみました。サンプルで作ったgemはこちら↓

任意のURLにHTTP POSTするdelivery_methodを定義したgemになります。

ということで今回は作り方の備忘として残します。

ActiveJobの仕組みを読み解く

Tue, 01 Aug 2017 07:30:19 +0000

ActiveJobの仕組みをざっくり読み解いてみました。Railsのバージョンは 5.1.2です。

do ... endと{ ... }の結合度

Wed, 26 Jul 2017 23:07:43 +0000

Rubyのdo … endと { … } はどちらもブロックを表すが、文法としての結合度が違う。

hoge = 123

def hoge(fuga = nil)
 puts fuga
 yield if block_given?
end

hoge hoge do "hoge" end
# => 123 

hoge hoge { "hoge" }
# => 
# hoge

do ... endの方は結合度が弱いのでhoge(hoge) do ... endとして解釈される
- なのでputs hoge(=変数)するだけ
{ ... }の方は結合度が強いのでhoge(hoge() { ... })として解釈される
- 内部のhoge呼び出しでputs nilして、yieldのreturnを外側のhogeでputsするのでputs "hoge"される

参考URL

ActiveRecordのパフォーマンス・チューニング

Wed, 19 Jul 2017 07:30:41 +0000

ActiveRecord周りのパフォーマンス・チューニングの備忘録。

DBレベルのチューニングはしたものの、Railsアプリのレイヤーでパフォーマンスを上げたい、という人向けの記事です。今回ベンチマークに使ったコードはこちらにあります。

N+1 partial renderingによるパフォーマンス問題

Tue, 18 Jul 2017 07:30:11 +0000

Ruby on RailsのN+1 partial renderingのパフォーマンス悪化を測定してみました。

コマンドラインからgitlabのファイルをダウンロードする

Thu, 15 Jun 2017 07:30:56 +0000

gitlabで wgetやcurlを使ってprivateなリポジトリのファイルをダウンロードしたいときの備忘録。

Ruby系のコマンドでits extensions are not built

Sun, 28 May 2017 16:02:06 +0000

あるときからruby系のコマンドを叩く度に以下のようなメッセージが表示されるようになった

Ignoring nokogiri-1.6.8 because its extensions are not built. Try: gem pristine nokogiri --version 1.6.8
Ignoring nokogiri-1.6.8.1 because its extensions are not built. Try: gem pristine nokogiri --version1.6.8.1
Ignoring bcrypt-3.1.11 because its extensions are not built. Try: gem pristine bcrypt --version 3.1.11
...

以下のコマンドを叩けば解消されます。

gem pristine --all

参考URL

ruby on rails - Bundle Error on macOS 10.12 Sierra - Stack Overflow

SPMのPackageサイト作ってみた

Thu, 25 May 2017 07:30:58 +0000

Salesforce Package Managerのpackageサイト作ってみました↓

SPM - Salesforce Package Manager -

wordpressの前段にCloudFrontを置いたときの備忘録

Sun, 14 May 2017 23:40:19 +0000

このたび、wordpressのサーバの前段にCloudFrontを置いたので、ハマったところを備忘として残しておきます。基本的には参考URLのやり方で設定すればOKです。

Railsのコントローラでsendメソッドを定義すると起こること

Sun, 14 May 2017 19:35:33 +0000

かなり初心者的ミスをしたので備忘録。

Windowsユーザ向けワンラインインストール

Mon, 08 May 2017 07:30:40 +0000

Windowsでワンラインインストールするためには、コマンドプロンプトやPowershellを使う必要があります。今回はPowershellを使ったワンラインインストールの方法を紹介します。

Dockerを使ったCLIツール配布

Sun, 07 May 2017 22:58:51 +0000

homebrewやcurl -sL {url} | shなどの/usr/local/binに置く以外にもdockerを使って配布できますよ、という備忘録。

bashでCLIを作ってみる

Wed, 03 May 2017 20:29:39 +0000

シェルスクリプトでオプション解析もごりごりやるようなCLIツールの作り方の備忘録。シェルスクリプトだけでCLIツールを作るメリットとしては可搬性と、パイプや標準入出力を用いた他のコマンドとの連携がやりやすいことです。

PLYでプログラミング言語を作る【グローバル変数】

Tue, 02 May 2017 12:00:44 +0000

lex/yaccでプログラミング言語を作るにはC言語を使う必要があるため、メモリ管理等の面でなかなか敷居が高いです。一方、PythonではPLYというlex/yaccのPython実装のライブラリが存在し、簡単にプログラミング言語を作成することができます。ということで、PLYを使ってプログラミング言語を作ってみました。

今回は以下の機能を作っていきます。サンプルコードはこちら。

ステートメントの順次実行
四則演算
グローバル変数のセット

ちなみにプログラミング言語作成に関してはドシロートなので色々ご了承ください。

apex-mastodon作ってみた

Tue, 02 May 2017 07:30:22 +0000

久々に、Apexで外部サービスのAPI叩いてみるシリーズ！ということで、apex-mastodonというApexのライブラリを作ってみました。

シンプルクローラー gocrawsanを作ってみた

Mon, 01 May 2017 07:30:25 +0000

golangでシンプルクローラ gocrawsanを作ってみました。ということでツールの紹介です。

force.com IDEで既存ディレクトリをプロジェクトとして追加する

Sun, 30 Apr 2017 15:08:33 +0000

antやgit cloneなどで作成したSalesforceのメタデータをforce.com IDEのプロジェクトとしてインポートをしたときの備忘録。retrieveしたモジュール一覧に対して開発を行いたい場合には参考にしていただければ！force.com IDEのバージョンは36.0.0.20160121512 です。

RailsでJOINしてORDERしてLIMITをかけたときの挙動

Tue, 25 Apr 2017 07:30:48 +0000

タイトルの通り、JOINしてORDERしてLIMITをかけたら、取得したレコードが期待した結果と違かった。ということで備忘録。Railsのバージョンは4系、5系両方で再現。

golangのnet/httpで自動リダイレクトしない方法

Tue, 25 Apr 2017 00:14:04 +0000

net/httpライブラリのhttp.ClientでHTTPレスポンスが3系だとデフォルトで自動リダイレクトする仕様になっている。リダイレクトしたくない場合は、CheckRedirect関数をオーバーライドしてhttp.ErrUseLastResponseを返せばOK。

Railsのviewとlayoutの評価順についてコードを読んで納得した

Mon, 24 Apr 2017 07:30:17 +0000

Railsのviewとlayoutの評価順序はview => layoutとなっており、viewで定義したcontext_forやprovideはlayout側でyieldすることで利用できるようになっていたり、layout側で引数無しのyieldをすれば評価後のviewのレンダリングが出来るようになっています。

今回、この挙動をコードレベルで理解したかったので関連する部分のコードリーディングをしてみました。

Railsのバージョンは5.0.1です。

zshの補完関数を作ってみた

Sat, 22 Apr 2017 17:30:58 +0000

zshの補完関数を作ったときの備忘録

Capistranoコードリーディング [基本]

Mon, 17 Apr 2017 07:30:28 +0000

Capistranoのコードリーディングをしてみました。今回はCapistranoが利用しているRakeの基本部分の紹介をします。

find_each、find_in_batchesとprimary_key

Mon, 17 Apr 2017 00:00:36 +0000

RailsのActiveRecordのメソッドであるfind_each、find_in_batchesとprimary_keyの備忘録。両メソッドの詳しい説明に関しては参考URLを参照してくださいー。

read_fragmentとフラグメントキャッシュ

Sun, 16 Apr 2017 23:00:54 +0000

Railsのフラグメントキャッシュでビュー側にcacheメソッド、コントローラ側にread_fragmentメソッドを利用するように書かれている記事があるけど併用すると害があるケースがありそうだったので備忘録。

ダミーデータを大量に作成するCLIツールdmyを作ってみた

Mon, 10 Apr 2017 07:30:25 +0000

パフォーマンステスト等の用途でダミーデータを大量に作成しないといけない局面があり、今までシェルスクリプトで作ったりRubyスクリプト叩いたりしてたんですが、

シェルスクリプトは他のコマンドを組み合わせるとコストが高くなりがち。
- 他のコマンドを組み合わせて利用できる柔軟性はあるものの、コマンド実行は別のシェル、プロセスを立ち上げることになるのでコストが高い
LLだと気軽かつそれなりの速度でデータを生成できるが、いちいちスニペットを作成する必要があるため面倒。
ダミーデータを作成するWebサービスはたくさんあるのですが、CLIツールはあまり無く、手元で作れたほうが効率的な場面がある

ということで、手軽にダミーデータを作成するCLIツールの"dmy"をgolangで作ってみました。

tzmfreedom/dmy: Command line interface to create dummy data

ActiveRecordのint型項目の最大値超過エラーについて

Thu, 06 Apr 2017 07:30:45 +0000

ActiveRecordでinteger型の項目をマイグレして、int型の最大値以上の数を入れて保存しようとすると、モデル側で以下のエラーが出ます。

ActiveModel::RangeError: 2147483648 is out of range for ActiveModel::Type::Integer with limit 4

最大値のエラーなのでエラー自体には納得なんですが、この手のエラーはバリデーションでerrorsに格納してほしいなーと思い、ソースコードを読んでみました。

golang標準ライブラリから学ぶタイムゾーンファイルの構造

Wed, 05 Apr 2017 07:30:03 +0000

今回はタイムゾーンファイルの構造をgolang標準ライブラリのloadZoneData関数から勉強してみました。

乃木坂46/欅坂46のCLIツールを作ってみた

Tue, 04 Apr 2017 07:30:19 +0000

乃木坂46/欅坂46のCLIツールを作ってみました。

Rubyプロセスの使用メモリ量の計測

Tue, 04 Apr 2017 00:30:21 +0000

Rubyプロセスの使用メモリ量を計測したときの備忘録

golangでgaroonのCLIツールgoroonを作ってみた

Mon, 03 Apr 2017 07:30:24 +0000

Garoonのスケジュール通知がmacOSではデフォルトで付いていなかったりして個人的に不便だったので、garoonのCLIツールをgolangで作ってみました。

tzmfreedom/goroon: Cybozu garoon library and command line interface by golang

golangのtimeライブラリでタイムゾーン変換

Sun, 02 Apr 2017 13:30:32 +0000

自分用メモ。

Homebrewの独自リポジトリをGithub Contents APIで自動更新する

Mon, 27 Mar 2017 07:30:55 +0000

HomebrewのFormulaを更新する場合

Formulaのバージョン
ダウンロードするファイルのSHA256

を変更する必要があります。毎回手作業でやるには面倒な上に、Travis CIなどでバイナリをビルドしてGithubのReleasesページに自動アップロードする処理を書いていたりすると、tarコマンド（GNU or BSD）やアーカイブ時間、UID/GIDの差異によって、tar.gzのバイナリが変わってしまうためハッシュ値取得のところでハマりやすいです。例えば、macOSで作成したtar.gzのハッシュ値とTravisの環境で作成したハッシュ値が異なるので、macOSからFormulaをgit commit/pushで更新する場合は、GithubのReleasesページからダウンロードしてきたものに対してハッシュ値を取る必要があります。

ということで今回はTravis CIでHomebrewの独自リポジトリをGithub Contents APIを使って自動更新する方法を紹介します。

Makefileや.travis.ymlの設定はこちらのリポジトリも参考にしてもらえればと思います↓ tzmfreedom/goroon: Cybozu garoon library and command line interface by golang

Vagrantでawait_response_stateエラー

Sun, 26 Mar 2017 22:25:27 +0000

vagrant upしたら以下のネットワークエラーが発生し、仮想OS自体は立ち上がるものの共有フォルダの機能が利用できなくなりました。

==> default: Configuring and enabling network interfaces...
/opt/vagrant/embedded/gems/gems/net-scp-1.1.2/lib/net/scp.rb:392:in `await_response_state': hogehoge (RuntimeError)

sshrcコードリーディング

Mon, 13 Mar 2017 07:30:19 +0000

sshrcのコードリーディングをしてみました。

HammerSpoonでアプリのフォーカス切り替えをHotKeyで実現する

Wed, 08 Mar 2017 00:24:03 +0000

HotKeyでのアクションはmacOSの場合はAutomatorを使うことが多いと思いますが、HammerSpoonでアプリのフォーカル切り替えを実現するには、init.luaにこんな感じで書けばOK。

hs.hotkey.bind({"alt"}, "J", function()
 hs.application.launchOrFocus("IntelliJ IDEA 15")
end)

hs.hotkey.bind({"alt"}, "E", function()
 hs.application.launchOrFocus("Evernote")
end)

hs.hotkey.bind({"alt"}, "C", function()
 hs.application.launchOrFocus("Google Chrome")
end)

hs.hotkey.bind({"alt"}, "S", function()
 hs.application.launchOrFocus("Slack")
end)

個人的にはHammerSpoonの方がスクリプト一発で書けるので好み。

golang標準ライブラリから学ぶzipファイルの構造

Mon, 27 Feb 2017 07:30:54 +0000

zipファイルの構造をgolangの標準ライブラリから勉強してみました。

Travis CIでgolangのテストを行う

Sun, 26 Feb 2017 21:32:55 +0000

Travis CIでgolangのテストを回したいときの.travis.ymlの設定についての備忘録。

Expeditorコードリーディング

Tue, 31 Jan 2017 07:30:02 +0000

cookpadさんのExpeditorのコードリーディングをしてみました。

macOSで起動時にvagrant upする

Thu, 26 Jan 2017 22:00:12 +0000

開発環境のvagrantを毎回vagrant upするのが面倒だったのでlaunchctlでOS X起動時にvagrant upしてみました。

Herokuの静的ファイルホスティングのベンチマーク

Thu, 26 Jan 2017 21:30:15 +0000

Free Dynoで静的ファイルホスティングのベンチマークを取ってみました。

Arproxyコードリーディング

Thu, 26 Jan 2017 07:30:15 +0000

cookpadさんのArproxyのソースコードリーディングをしました。

zshとか便利コマンドあれこれ

Tue, 24 Jan 2017 07:30:56 +0000

zshやら便利コマンドのあれこれ備忘録。alias書いたり.zshrc読み書きする用。

macOS Sierraでキーリマップする

Mon, 23 Jan 2017 07:30:36 +0000

macOS Sierraでvimで Ctrl-[ でコマンドモードに抜けるときにIMEを無効化する処理をHammerspoonを使って設定してみました。

macOSでGNU dateを使う

Sat, 21 Jan 2017 07:30:19 +0000

macOSで初期にインストールされているdateコマンドはBSDバージョンなので、GNUバージョンを使うには以下のコマンドでインストールすればOK。

 $ brew install coreutils

このままだとgdateと打たないといけないので、dateコマンドとして使いたい場合はrcスクリプトに以下のaliasを張っておけば良い。

alias date='gdate'

ActiveModelのバリデーションメッセージのキー値を日本語化する

Tue, 10 Jan 2017 07:30:37 +0000

ActiveModelをインクルードしたクラスでvalidationでエラーにする場合、項目の名前をconfig/locales/**.ymlに設定してあげないとキーの値がそのまま出てしまう（正確にはアンダースコアがスペースに置換される）

lastpass-cli触ってみた

Thu, 05 Jan 2017 07:30:52 +0000

Lastpassが公開している公式のコマンドラインツールであるlastpass-cliを試してみました！

2017

Sun, 01 Jan 2017 00:00:00 +0900

今年の振り返り〜2016年〜

Sat, 31 Dec 2016 14:00:29 +0000

“技術"とか"仕事"とかそういった文脈で2016年を振り返ってみたり。

golangでCLIを作ったときの備忘録

Thu, 22 Dec 2016 07:30:50 +0000

先日、SPMというコマンドラインツールをリリースしましたが、golangでコマンドラインツールを作成する上で便利だったツールや考え方等を備忘として残します。

SourceTreeで隠しディレクトリ内のパスを指定して新規リポジトリを作成する方法

Wed, 21 Dec 2016 07:30:11 +0000

タイトルの通り、隠しディレクトリ内のパスを指定したい、というときの方法について。

gowsdlでSalesforceのSOAP APIを叩く

Tue, 20 Dec 2016 07:30:49 +0000

今回はgowsdlを使ってSalesforceのSOAP APIを叩いてみます。

gowsdlの使い方

こんな感じでコマンドを叩けばOK

$ gowsdl {URL} // -p で出力先ディレクトリを変更する

ローカルファイルは読み込んでくれないので、Web上に置く必要があります。Salesforceの各種WSDLはWeb上にあるものの、いずれも認証を必要とするので、ダウンロードしたWSDLをS3にPublicなオブジェクトとしてデータをアップロードしたりする必要があります。ただし、Enterprise WSDLはスキーマ情報がそのまま乗るので取扱には注意です。試してませんがローカルにサーバ立てて、そこで配信するのが手軽でセキュアかも。

partner.wsdlでやってみるとこんな感じでエラーが出ます。

$ gowsdl -p partner https://s3-ap-northeast-1.amazonaws.com/{BUCKET}/partner.wsdl

　　Downloading file https://s3-ap-northeast-1.amazonaws.com/{BUCKET}partner.wsdl
　　Downloading external schema location 
　　https://s3-ap-northeast-1.amazonaws.com/{BUCKET}/partner.wsdl
　　expected element type schema but have definitions

gowsdlはシングルバイナリなので、デバッグ仕込んだりすることは出来ませんが、ベースとなっているソースコードを直接いじることで原因を調査することができます。

$ go run $GOPATH/src/github.com/hooklift/gowsdl/cmd/gowsdl/main.go \
 https://s3-ap-northeast-1.amazonaws.com/{BUCKET}/partner.wsdl

ということで、ここらへんをコメントアウトして無理矢理動かします（白目）

diff --git a/gowsdl.go b/gowsdl.go
index e136e27..6464a7d 100644
--- a/gowsdl.go
+++ b/gowsdl.go
@@ -176,9 +176,9 @@ func (g *GoWSDL) unmarshal() error {
 
 for _, schema := range g.wsdl.Types.Schemas {
 err = g.resolveXSDExternals(schema, parsedURL)
- if err != nil {
- return err
- }
+ // if err != nil {
+ // return err
+ // }
 }
 
 return nil

これでとりあえずクライアントは自動生成できます。自動生成されたパッケージを少し修正して動かしてみます。まずはパッケージ名をmainに変更します。

ログインシェル変更時にSSHでPermission deniedと言われたときの対処法

Mon, 19 Dec 2016 07:30:13 +0000

仮想環境上のzshのバージョンを上げるために、ソースコードからインストールし、再度SSHでログインしようとしたときに以下のエラーが発生した。

$ vagrant ssh
Permission denied (publickey,gssapi-keyex,gssapi-with-mic,password).

Salesforce Package Manager "SPM"を作ってみた

Mon, 12 Dec 2016 00:05:02 +0000

Salesforceのパッケージ管理システム"SPM"をリリースしましたー

tzmfreedom/spm: Salesforce Package Manager

一応マルチプラットフォーム対応で、バイナリも配布しているので是非お試しください。マルチプラットフォーム対応を謳っておきながらwindowsでの動作は全くの未確認（！）なので、不具合があればissueやらPRやらお願い致しますー。

LINE Messaging APIを触ってみた

Tue, 15 Nov 2016 07:30:20 +0000

LINE Messaging APIを触ってみました。ということで備忘録。

UNIX V6コードリーディング備忘録　その１

Mon, 14 Nov 2016 07:30:26 +0000

はじめてのOSコードリーディング UNIX V6で学ぶカーネルのしくみが面白すぎたので備忘録。

今回は2章プロセス、3章プロセスの制御、7章ブロックデバイスサブシステム、9章ファイルシステムを対象に書いていきます。

HomeBrewのFormulaを作ってみた

Fri, 11 Nov 2016 07:30:19 +0000

HomeBrewのFormulaを作ってみました。ということで備忘録。

PHPのextensionを作ってみた

Thu, 10 Nov 2016 07:30:13 +0000

PHPのextensionをCで直接書く方法（公式）とZephirで書く方法の２パターンで作ってみました。

phpのセッション管理あれこれ

Tue, 08 Nov 2016 07:30:42 +0000

PHPのセッションの管理方法に関する備忘録。

俺のためのtmuxまとめ

Mon, 07 Nov 2016 07:30:41 +0000

俺のためにtmuxの操作方法と設定方法をまとめました。tmuxはバージョン2.3を使用。

IntelliJのDatabaseビューの便利機能

Fri, 04 Nov 2016 07:30:43 +0000

IntelliJのDatabaseビューが便利すぎたという備忘録

DigitalOceanのUbuntuでphp5.6-fpmを入れる

Thu, 03 Nov 2016 07:30:58 +0000

DigitalOceanのUbuntu 14.04やUbuntu 16.04でphp5.6のphp-fpmをインストールするときの備忘録。

Apache+mod_phpなwordpressをh2o+php-fpmに置き換えた

Wed, 02 Nov 2016 07:30:15 +0000

H2Oの勉強がてらブログのアーキテクチャをApache + mod_phpからH2O + php-fpmの構成に変えてみました。ということで今回は移行に関する備忘録。

初心者がRails+DeviseでTodoアプリ作る【Omniauth編】

Tue, 01 Nov 2016 07:30:13 +0000

Omuniauthを使ってRailsアプリにソーシャルサインオンの機能を追加してみました。

H2OでHTTP/2を体感する

Fri, 28 Oct 2016 07:30:36 +0000

HTTP/2対応のWebサーバソフトウェアであるh2oを試してみました。

よく使うHerokuコマンドまとめ

Thu, 27 Oct 2016 07:30:32 +0000

よく使うHerokuコマンドの備忘録

launchdでデーモンやスケジュールタスクを管理する

Wed, 26 Oct 2016 07:30:24 +0000

Linuxだとserviceやcronを使いますが、OSXだとlaunchctlを使うようです。ということで、launchctl（launchd）の使い方を備忘としてまとめました。

MetaMindのRuby Clientをリリースしました

Tue, 25 Oct 2016 07:30:45 +0000

MetaMindのRuby Clientが無かったので作っちゃいました。

秘密鍵、公開鍵、証明書、CSR生成のOpenSSLコマンドまとめ

Mon, 24 Oct 2016 07:30:34 +0000

よくある秘密鍵生成のコマンドまとめ

なお、OpenSSLのコマンドの使い方はサブコマンドのmanページを見るのが手っ取り早いです。

Apache BenchでConnection Refusedエラー

Thu, 13 Oct 2016 07:30:38 +0000

Apache Benchで以下のコマンドを入力したらエラーになった。

初心者がRails+DeviseでTodoアプリ作る【RSpec・Travis CI・Rubocop】

Wed, 12 Oct 2016 07:30:39 +0000

前回は認証までだったので、今回はテストコード関連の以下のタスクをやっていきます。

Rubocopによる静的コードチェック
RSpecによるテストコード作成
TravisCIによるCI

ActiveRecordのpreload, includes, eager_load

Tue, 11 Oct 2016 07:30:08 +0000

よくあるpreload, includes, eager_loadの違いについて実際に打ってみて確認してみた。今回はuserレコードがtaskレコードに対して1対多のERにおいてuserとそれに紐づくtaskを取得するようなクエリの挙動を確認します。

Salesforce MetaMind試してみた【QUICK START編】

Thu, 06 Oct 2016 07:30:56 +0000

今年もDreamforceが始まりましたね！今年は現地には居ませんが、タイムラインを見て気になったサービスを試してみたいと思います。ということで、今回はSalesforce MetaMindを試してみました。

IntelliJからHeroku Postgresに接続する

Wed, 05 Oct 2016 07:30:20 +0000

IntelliJのDatabase ConsoleでHeroku Postgresに接続するときの備忘録

RubyでPostgreSQLのレコードをCSV出力してみた

Tue, 04 Oct 2016 07:30:54 +0000

RubyでPostgreSQLのレコードをCSV出力したときの備忘録。PostgreSQLの場合、psqlでCOPY文を投げればCSV化してくれますが、一部を変数に置き換えたり、条件を柔軟に切り替えたり、自動化するにはやはりプログラムからSQLを投げるのが良かったりします。

Soapforce使ってみた

Sun, 02 Oct 2016 07:30:17 +0000

Ruby製のSalesforce APIクライアントのSoapforceを使ってみました。名前の通り、SOAP APIで実装されています。

Ruby製の APIクライアントだとrestforceが有名だと思いますが、今回はバルク処理をどうしても行いたかったため、Soapforceを使ってみました。winter16でREST APIのSObject Treeが正式リリースされたので、そっちを使ってもOKですが…。

ActiveAdmin触ってみた

Thu, 29 Sep 2016 07:30:43 +0000

Railsのお勉強シリーズ。今回は管理用の画面を簡単に作成できちゃうActive Adminを試してみます。詳細な使い方はactiveadmin.infoはout of dateなのでgithubのdocを見ることになります。今回は、Rubyは2.2.4、Railsは5系を使いました。

Settingslogicコードリーディング

Wed, 28 Sep 2016 07:30:23 +0000

Rubyのお勉強がてら、Settingslogicのコードリーディングをしてみました。

gRPCを触ってみた

Tue, 27 Sep 2016 07:30:18 +0000

gRPCはRPCのフレームワークの一つです。SOAPと同じ分類になりますが、SOAPとの違いは以下になります。

IDLの記述が容易（かつ人間が読める）
コードジェネレータにより様々な言語に対応
プロトコルはHTTP/2
デフォルトではメッセージフォーマットとしてProtocolBuffersを利用するため、シリアライズ、デシリアライズが高速

ということで今回はRubyとPythonでgRPCなサーバ、クライアントを作成してみました。

GrapeでTodoアプリなAPIを作ってみた【OAuth2.0対応まで】

Mon, 26 Sep 2016 07:30:16 +0000

TodoアプリなAPIサーバをRubyのWAFであるGrapeで作ってみました。

利用技術はこんな感じ↓

APIフレームワーク => Grape（Railsにマウント）
認証用の画面 => Rails + Devise
OAuth2.0 => doorkeeper

Rubyは2.2.4、Railsは5.0.0.1です。

MessagePackを触ってみた

Fri, 23 Sep 2016 07:30:16 +0000

MessagePackとはシリアライズ（バイナリエンコード）の方法の一つで

シリアライズ/デシリアライズが高速
シリアライズされたサイズが小さい

とProtocolBuffersと似たような性質を持ちますが、ProtocolBuffersと違って

IDLが不要で汎用的
ストリーム処理が可能（ProtocolBuffersでも出来るのかもしれませんが）

という特徴を持ちます。TreasureDataのバックエンドであるPlazmaDBやfluentdでも利用されている技術になります。

ということで今回はMessagePackを触ってみました。

Clockworkを使ってHerokuでバッチ処理

Thu, 22 Sep 2016 07:30:45 +0000

Herokuでプログラムをスケジュール起動する場合は、Heroku Schedulerが主に使われると思いますが、Heroku Scheduler自体はベストエフォート型のサービスだったり、細かい時間の制御ができなかったり色々と融通が利かない部分があります。ということで今回はClockwork + Resqueでバッチ処理を作ってみます。

Protocol Buffersを触ってみた

Wed, 21 Sep 2016 07:30:11 +0000

Protocol Buffersはデータ構造をシリアライズする技術になります。いわゆるXMLやJSONみたいなものではありますが、バイナリ形式なので「サイズが小さい」「シリアライズ、デシリアライズが高速」でprotoファイルによってメッセージ定義を「シンプルに記述可能」なのが売りです。またメッセージ定義はプログラムにコンパイルされるため、プログラムから利用しやすいのも利点です。

ということで今回はProtocol Buffersを触ってみました。

初心者がRails+DeviseでTodoアプリを作ってみた【Herokuにデプロイするまで】

Tue, 20 Sep 2016 07:30:24 +0000

2番煎じどころか100番煎じくらいだと思いますが、Ruby on Rails+Deviseで認証機能付きTodoアプリを作ってみました。

今回やることは以下です。

Railsアプリのプロジェクトを作成
Deviseインストール＆設定
各種モデル作成＋マイグレーション
ルーティング設定
コントローラ作成
メール送信設定
Herokuアプリ作成＋設定＋デプロイ

Rubyのバージョンは2.2.4、Railsは5.0.0.1です。

EmbulkのAnalytics Cloudのプラグインをリリースしました

Mon, 13 Jun 2016 07:30:54 +0000

EmbulkのAnalytics Cloudのプラグインを作成、リリースしましたー。

jsforceを使ったSalesforce便利TIPS

Wed, 25 May 2016 07:30:21 +0000

jsforceはメタデータ操作が他の言語のライブラリよりも扱いやすいので、手軽に高度なことができちゃいます。ということで便利なオレオレTIPSを備忘として残しておきますー

PowerShellに入門してみた

Tue, 24 May 2016 07:30:32 +0000

PowerShellが便利だということに今さら気づいたので、使い方をざっとまとめましたー

Elastic SearchでToo many open filesが出た時の対処法

Mon, 23 May 2016 07:30:27 +0000

アイドルEFKスタックが止まっていたので、{elastic search path}/logsディレクトリ内のログを確認したところ、以下のようなエラーが発生してました。

Let's Encryptの証明書を更新してみた

Fri, 20 May 2016 07:30:40 +0000

Let’s Encryptから「もうすぐ期限切れになるよー」メールが届いたので対応しました。

Treasure DataのAPIを叩いてみた

Thu, 19 May 2016 07:30:47 +0000

Treasure DataのAPIを叩くときは各種言語のライブラリを利用するのがほとんどだと思いますが、REST APIを実際に叩いて何が出来るのか確認してみましたー

embulkを使ってTreasure Dataにjsonl形式のデータを流し込む

Mon, 16 May 2016 07:30:57 +0000

embulkを使ってTreasure Dataにjsonl形式のデータを流し込んでみました。

ElixirでforceのAPIを叩いてみた

Wed, 11 May 2016 07:30:41 +0000

Elixirのforce.com用ライブラリのforcexを使ってforce.comのAPIを叩いてみました。

Heroku ConnectのAPI叩いてみた

Tue, 10 May 2016 07:30:25 +0000

Heroku Conncect APIを叩いてみましたー。ということで、いつもどおり備忘録

bit.lyとGoogle URL ShortenerのAPI叩いてみた

Mon, 09 May 2016 07:30:38 +0000

今更ながらURL短縮サービスのbit.lyとGoogle URL ShortenerのAPIを叩いてみましたーということで備忘録

PythonのWebアプリフレームワークFalcon試してみた

Tue, 26 Apr 2016 07:30:38 +0000

Falconという高速・シンプルなWebアプリフレームワークを触ってみましたー

PHPの高速WebアプリフレームワークでPhalconというのがありますが、PythonはFalconになります。

PointDNSのAPIをforce.comから叩く

Mon, 25 Apr 2016 07:30:23 +0000

PointDNSはDNSのサービスで、HerokuでAddonとしても提供されています。今回は、ApexからPointDNSのAPIを叩いてDNSレコードの追加、変更を自動化できるようにします。

技術ブログあれこれ

Fri, 22 Apr 2016 07:30:15 +0000

祝200記事！ということで技術ブログに関する考えをざっくばらんに。伝えたい、というよりは自分の考えを整理したいっていうモチベーションで書いているので、あんまり参考にならないかもですが…。

Apexでコミュニティユーザを作成する

Thu, 21 Apr 2016 07:30:30 +0000

Apexでコミュニティユーザを作成する方法の備忘録

Salesforce to Salesforce試してみた

Wed, 20 Apr 2016 07:30:44 +0000

Salesforce to Salesforceを試してみましたーということで備忘録。手順や詳細は参考URLのPDFの方が詳しいので併せて確認すると良いです。

FIFO試してみた

Tue, 19 Apr 2016 07:30:16 +0000

名前付きパイプのFIFOに関する備忘録

Apexでコミュニティロールの共有設定

Mon, 18 Apr 2016 07:30:35 +0000

Apexを使って、コミュニティのロールに対して共有レコードを割り当てる時の備忘録。

Pythonでselect, poll, epoll, kqueue試してみた

Fri, 15 Apr 2016 07:30:06 +0000

I/O多重化のシステムコールのselect, poll, epoll, kqueueをPythonで試してみましたー。Pythonは2.7系を利用しました。

FacebookのMessenger用Botをforce.comで作ってみた

Thu, 14 Apr 2016 07:30:51 +0000

今度はFacebookのMessanger用Botが出たようなので例の通り、force.comで試してみましたー

Webサーバのチューニングを体感する

Wed, 13 Apr 2016 07:30:12 +0000

Webサーバのアプリ／DB以外での一般的なチューニングに関して体感してみましたー

Spark/PySparkでツイート分析してみた

Tue, 12 Apr 2016 07:30:51 +0000

Twitter Streaming APIでかき集めたツイートをSparkで分析してみました。

Hadoop版はこちら→Hadoop Streamingでアイドルツイート分析

Hive版はこちら→Hiveでツイート分析

LINE BOT APIをforce.comで試してみた

Mon, 11 Apr 2016 07:30:09 +0000

巷で話題のLINE BOT APIをforce.comで試してみましたー

Hiveでツイート分析

Mon, 28 Mar 2016 07:30:22 +0000

今度はHiveを使ってツイートを分析しました。１行１JSONのファイル（Fluentd＋Twitter Streaming API）がS3にGZIP形式で格納されているので、このファイルをHiveで処理していきます。環境はMac OS Xです。

Hadoopバージョンはこちら→Hadoop Streamingでアイドルツイート分析

Let's EncryptでHerokuアプリを独自ドメインSSL化

Thu, 24 Mar 2016 07:30:35 +0000

Let’s EncryptをHerokuアプリに適用して、独自ドメインSSL化してみました。言語はPHPで。

start-stop-daemonいじってみた

Wed, 23 Mar 2016 07:30:29 +0000

Ubuntuとかでnginxのinitscript見るとstart-stop-daemon使ってデーモン化していて、デーモン化する手段として覚えておいた方が良さそうだなーと思ったので触ってみました。

Hadoop Streamingでアイドルツイート分析

Tue, 22 Mar 2016 07:30:28 +0000

Fluentd+ElasticSearch+Kibanaでアイドルデータ分析基盤を作ってみたの回で、FluentdとTwitter Streaming APIを使ってS3にツイートデータを保存したので、このデータをHadoopを使って解析してみます。

今回はMeCabを使って形態素解析してワードカウントを取るような教科書的なMapReduceを試してみました。Hadoop Streamingを使ってPythonでMapper、Reducerを書いていきます。

ElasticSearchの設定あれこれ

Tue, 15 Mar 2016 07:30:32 +0000

前回の記事のElasticSearchの設定に関する補足。

Google Analytics APIとD3.jsでアクセス数をビジュアライズ

Mon, 14 Mar 2016 07:30:56 +0000

Google Analytics API＋D3.jsでブログ記事ごとのアクセス数をビジュアライズしてみました。

FuelSDK-NodeとExactTarget APIあれこれ

Wed, 09 Mar 2016 07:30:13 +0000

ExactTargetのNode.js用SDKであるFuelSDK-NodeとExactTarget APIに関する備忘録

Ubuntu 14.04@DigitalOceanのオレオレ初期セットアップ

Tue, 08 Mar 2016 07:30:12 +0000

DigitalOceanのVPSを検証用によく利用しているんですが、基本的な設定は全て自分で行う必要があります。特にsshd、iptables、ユーザの作成の部分は基本的には絶対にやらないといけない共通設定なので、備忘として残しておきます。OSはUbuntu 14.04です。

Fluentd+ElasticSearch+Kibanaでアイドルデータ分析基盤を作ってみた

Mon, 07 Mar 2016 07:30:23 +0000

俺もビッグデータの分析とかやってみたいなー →Twitterとか身近なビッグデータっぽくて扱いやすそう →よし、アイドル（坂道シリーズ）に関するツイート集めて分析してみよう

という軽いノリでFluentd + ElasticSearch + Kibanaというよくある構成で分析基盤（？）を作ってみました。

今回は基盤作るまでのインストール＆設定地獄の備忘録。（自力でやんなくてもDockerやChefで一発で構築できるモノが出回ってそうですが…）

ElectronでExactTargetのGUIツール作ってみた

Mon, 22 Feb 2016 07:30:15 +0000

ElectronでExactTargetのGUIツール作ってみました↓ Releases · tzmfreedom/ET_Tool

リファクタリングとかアイコンとか細かいところは完全無視してとりあえずリリース。

ExactTargetでSalesforce連携

Mon, 15 Feb 2016 10:00:20 +0000

ExactTargetのSalesforce連携を利用すると、ExactTargetの画面からSalesforceのオブジェクトやレポートデータをインポートしたり、そのデータを使って一括メール送信をすることが可能です。

Pythonのargparseをテストする

Sun, 14 Feb 2016 10:00:46 +0000

Pythonのargparseモジュールを利用するとPythonスクリプトに渡された引数のチェックを良い感じにやってくれます。自動的にヘルプコマンドも作ってくれたりするので、コマンドラインツールを作るときにはかなり便利です。

今回はargparseによるコマンドライン引数のパースをunittests + Mockでテストしてみました。Pythonのバージョンは２系です。

Angular.jsでBrowserify

Fri, 12 Feb 2016 10:00:56 +0000

Angular.jsでBrowserify対応するときに色々ハマったので、その備忘録。

Marketing Cloud Connector(v5)触ってみた【メール送信編】

Thu, 07 Jan 2016 07:30:25 +0000

前回はインストールまでやったので今回は実際のメール送信の部分をやっていきます。メール送信方法には、Contact・Leadに対して一件ずつメールを送信する方法、レポートやキャンペーンを使って一括でメール送信をする方法、ContactやLeadに紐づくオブジェクトが作成、更新された際にリアルタイムにメールを送信する方法の３パターンあります。

Python初心者がPyPIにコマンドラインツールを登録してみた

Wed, 06 Jan 2016 07:30:05 +0000

ExactTargetのCLIを仕事の便利ツール的な感じで作っていたのをPyPIに公開してみました。↓

et-cli Python Package Index

$ pip install et-cli

でインストールできるようになってますので、ExactTarget導入している開発者の方は良ければお使いください（日本ではほとんど居ないと思いますが…）。ツールの説明は別の記事として書こうと思います。まだまだ機能不全＋クソコードな感じなのでもうちょい時間作って書いていかないとなー。

ということで、今回はコマンドラインツールをPyPIにパッケージ登録するやり方を書いていきます。

AWS CLIのHTTPキャプチャ

Sun, 03 Jan 2016 16:40:47 +0000

AWSのREST APIはリファレンスもあるしSignatureの生成方法も載っているので、SDKが無いような言語でAPI叩きたい場合でも大抵問題ないんですが、それでも仕様が謎でどういうリクエスト投げれば良いんだ！？っていうケースもあると思います。

そんなときは各種SDKのコードを読むか、SDKを使ってAPIコールしてHTTPの中身を見るかして仕様を把握する感じになりますが、今回は後者のSDKを使ってAPIコールの中身を見る、というのをやっていきます。

レポート通知のカスタムアクション試してみた

Sun, 03 Jan 2016 13:50:26 +0000

Spring ’15からレポート通知の機能が利用できるようになっています。任意のレポートがある条件を満たした時に特定のアクションを実行させることができる機能で、ログインユーザレベルで設定できるものになります。具体的には「毎日午前10時に未解決のケースが100個以上溜まっている状態であれば、登録者に対してChatterやメール通知する」といったことが出来るようになります。

PythonのSalesforceライブラリ調べてみた

Sun, 03 Jan 2016 13:05:09 +0000

Salesforce触っていると、アドホックにデータを操作したいときが結構あるんですが、Pythonってそういうのないのかなーと思って、ちょっくら調べてみましたので備忘として残しておきます。

Apex Batchで既存レコードを使わずに回してみる

Thu, 31 Dec 2015 16:00:45 +0000

普通に知らなかったので備忘録として…。

BatchableなInterfaceを実装するApex Batchですがexecuteに入ってくるレコードは実在するSObjectじゃなくても良いし、そもそもSObjectである必要もなく、プリミティブやカスタムなApexClassも入れられちゃいます。

つまり、startの戻り値はDatabase.QueryLocatorではなくSytem.InterableなものもOK、ということです。（リファレンスに思いっきりstartメソッドが2つ定義されています）

2016

Fri, 01 Jan 2016 00:00:00 +0900

Heroku Postgresからのエクスポート

Wed, 30 Dec 2015 23:00:22 +0000

Heroku Postgresからのエクスポートの備忘録（今更感ありますが…）

Marketing Cloud Connector(v5)触ってみた【インストール・設定編】

Wed, 30 Dec 2015 19:00:38 +0000

Salesforce Marketing CloudのExactTargetではSalesforceと連携することが出来ます。具体的には以下のような連携をすることができます。

ExactTargetの画面からSalesforceのレポート、キャンペーンを使ってメールを送信する
ExactTargetの画面からSalesforceのレポートのレコードをDataExtensionに格納する
Salesforceの画面からExactTargetの機能を使ってメールを送信する（ログもSalesforce側にレコードとして格納）

これらのうち３番目のSalesforce画面から起動するタイプのものはSalesforceのパッケージのMarketing Cloud Connectorを利用する必要があります。今回はこのConnectorのインストール、設定からメール送信までやっていきます。

ExactTargetのMobilePush試してみた【iOS編】

Wed, 30 Dec 2015 19:00:23 +0000

今回はiOSアプリに対してExactTargetのPush通知機能を実装してみます。

参考URL

Journey Builder for Apps iOS SDK

Androidの実装に関しては過去記事を参照してください↓

MobilePush Demographicsの確認方法

Wed, 30 Dec 2015 19:00:03 +0000

ExactTarget(Marketing Cloud)のMobile Push Contactの属性情報の確認方法についての備忘録。

Heroku Postgresのスキーマをローカルに落として開発する

Tue, 29 Dec 2015 13:50:31 +0000

Heroku Connectを使うとHeroku Postgres側に自動的にスキーマが生成される感じになるので、開発する場合は

ローカル開発環境からHeroku PostgresのDBに直接接続する
Heroku Postgresのスキーマをローカル環境に持っていく

の２パターンで開発することになります。ただ、前者の場合は同一DBに複数人が開発用として接続することになるので、ミスってデータやテーブルを削除したときや、ユニークなデータを格納したつもりがバッティングしてダメとか、開発上色々と問題があります。さらに東京-US間のレイテンシがあるのでDB接続も低速です。

ということで、実際に開発する場合は後者のパターンになるのですが、この「Heroku Postgresのスキーマをローカルに持っていく」やり方を備忘として残しておきます。

ExactTargetのMobilePush Contactにカスタム属性を追加する

Sun, 27 Dec 2015 17:30:34 +0000

ExactTargetのMobilePushのContactにはカスタム属性を追加することができ、独自の属性情報によりパーソナライズやセグメンテーションが出来るようになります。

FuelSDK-Python触ってみた

Sun, 27 Dec 2015 17:30:00 +0000

ExactTarget(Marketing Cloud)のpythonのSDKであるFuelSDK-Pythonを触ってみたのでメモっておきます。pythonのバージョンは2.7.xを使用してください。

Phalconあれこれ2

Sun, 27 Dec 2015 13:00:36 +0000

phpのWebアプリケーションフレームワークphalconのあれこれ第二弾。バージョンは2系です。

phalconのレスポンスの挙動について調べてみた

Mon, 21 Dec 2015 07:30:39 +0000

今回はphalconのレスポンスの書き方と挙動について書いていきます。サンプルは全てコントローラのアクションメソッド内での処理を想定しています。また、Phalcon\Mvc\ApplicationのuseImplicitViewがtrueの前提で記載していきます。

phalconのdispatch内のイベント

Sun, 20 Dec 2015 07:30:23 +0000

phalconのdispatcher内のイベントについて備忘として残しておきます。

ExactTargetのJourneyBuilder試してみた【MobilePush編】

Fri, 18 Dec 2015 07:30:19 +0000

ExactTarget(SalesforceMarketingCloud)のJourneyBuilderでMobilePushをやってみました。

今回の参考URL→Salesforce-Marketing-Cloud-Developer-Edition-Recipes/firing-events.md

また、MobilePushのSDK組み込みやアプリケーション設定に関しては以下の記事を参考にしてください。

phpのxdebugでハマった話

Thu, 17 Dec 2015 07:30:55 +0000

phpのデバッグでNetBeans＋xdebugを使おうとしたのですが

ポート（9000）は開いているしtcpdumpした感じはちゃんと通ってる。
phpinfo()でもちゃんとxdebugがenableになっているし、設定もうまくいっているように見える。
NetBeansで「最初の行で停止」にチェックをつけると、最初の行では止まってくれる。
ブレークポイントで止まってくれない。デバッグ文でコード自体は通っていることは確認済み。

という感じで、デバッグできない状況になりました。

カスタム接続アプリケーションハンドラ試してみた

Wed, 16 Dec 2015 07:30:53 +0000

Winter ‘16でカスタム接続アプリケーションハンドラなるものがリリースされたので、こちらの機能を試してみました。

この機能は接続アプリケーション(OAuth, SAML)の振る舞いを変更することができます。具体的には以下の振る舞いを変更することができます。

「管理者が承認したユーザは事前承認済み」のポリシーにおけるauthorize処理
refresh tokenによるrefresh処理
userinfoやSAMLアサーションに利用されるカスタム属性の動的生成

カスタム接続アプリケーションハンドラ自体はAuth.ConnectedAppPluginクラスを継承して実装することになります。詳細はこちらを参照→ConnectedAppPlugin Class | Force.com Apex Code Developer's Guide | Salesforce Developers

codeceptionでphalconの単体テストしてみた【FunctionalTests編】

Mon, 14 Dec 2015 07:30:08 +0000

前回はincubatorでUnitTestsな単体テストをしましたが、今回はFunctionalTestsの方でトライしてみます。 codeceptionのインストールは前回の記事を参照してください。

phalconあれこれ

Sun, 13 Dec 2015 07:30:23 +0000

phalconの細かすぎず、伝わりやすい話。2系の話です（1系でもそうかもしれないけど未検証）。

codeceptionでphalconの単体テストしてみた【incubator編】

Mon, 07 Dec 2015 07:30:27 +0000

codeception＋phalcon/incubatorでphalconの単体テストをやってみました。

codeceptionではブラウザと実際に稼働しているアプリケーションを使ったAcceptanceTest、アプリケーション（各フレームワーク対応）をテスト実行時に内部で動かすFunctionalTest、従来型の単体テストを行うUnitTestがあります。今回はUnitTestでの単体テストの方法を書いていきます。

ApexからAWS IoTのAPI叩いてみた

Thu, 03 Dec 2015 00:05:12 +0000

~~IoT Cloudがいつまで経っても利用できそうにないので~~AWS IoTが面白そうなので Apexから触ってみました。今回はThingは利用せずに、Message BrokerにHTTPで送ってRulesで処理をさせるという構成でやってみました。

ExactTargetのAPI叩いてみた【Triggered Email編】

Tue, 06 Oct 2015 07:30:05 +0000

前回はEmailSendDefinitionを使ってメールを送信したので、今回はTriggered Emailを使ってメールを送信したいと思います。EmailSendDefinitionの方法はあるユーザ（＝Subscriber）の集団に対して一括でメールを送信するユースケースに利用するのに対し、Triggered EmailはSubscriberの任意のアクションに対して、メールを送信するようなユースケースで利用することになります。具体的には、「問い合わせフォームで問い合わせを完了した時に、確認メールをユーザ宛に送信する」といったWebサイトのアクションに対するメール送信等に利用します。

ExactTargetのMobilePush試してみた【Android・後編】

Mon, 05 Oct 2015 07:30:43 +0000

前回はWebのUI上からPush通知をしましたが、今回はAPIで送信してみます。 APIで送信するには事前にApp Centerのアプリケーション登録が必要です。こちらの記事を参照して事前にセットアップしてください。

参考URL

Analytics Cloud External Data API試してみた

Wed, 30 Sep 2015 07:30:03 +0000

Analytics CloudではSalesforceのオブジェクトだけでなく、CSVを外部データとして取り込むことができます。今回はCSVによるデータ取り込みをExternal Data APIを使って取り込んでみます。External Data APIといっても、やることはロード用のオブジェクトにデータを格納するだけで、あとは勝手にAnalytics Cloud側がデータ取り込みと変換をやってくれます。

参考URLは以下になります。

Lightning Process BuilderでInvokableMethod試してみた

Tue, 29 Sep 2015 07:30:43 +0000

SalesforceのLightning Process BuilderはGUIでワークフローを構成することができる機能ですが、Apexコードを呼び出せるのが一つの特徴となっています。そこで、今回はApexコード呼び出し（InvokableMethod）を試してみました。

ExactTargetのMobilePush試してみた【Android・前編】

Mon, 28 Sep 2015 07:30:56 +0000

ExactTargetのMobilePush(Android)を試してみたので備忘として残しておきます！

参考URL：Journey Builder for Apps Android SDK (v4.0.6) : README

Salesforce Mobile SDKでAndroidのPush通知やってみた

Fri, 25 Sep 2015 07:30:17 +0000

SalesforceのMobile SDKを使ってPush通知が出来るようなので、Androidで試してみました。JDKやAndroid Studioのインストールは完了済みとして、そこからの構築工程を備忘として残しておきます。環境はwindows 8 です。

参考URLはこちら

Dreamforce '15 行ってきた。

Thu, 24 Sep 2015 07:30:37 +0000

会社のお金でDreamforce ‘15行ってきました。最高のイベントでした。まさに夢のforceでした。 Salesforce好きな人なら一生に一回は自腹切ってでも行くべきだと思いました。 Salesforce嫌いな人でもラテン系な熱気が相まって化学反応が起こるかもしれないので行ってみることをオススメします。人によりますが、一生に一回で50万円の自己投資は安いと思えるくらいの衝撃は味わえると思います。

Windowsのファイル共有自動化のためのコマンドまとめ

Thu, 03 Sep 2015 07:30:33 +0000

Windowsのファイル共有に関して、コマンドで自動化するための情報を備忘として残しておきます！

ExactTargetのSOAP API叩いてみた【一括メール送信編】

Tue, 01 Sep 2015 07:30:41 +0000

ExactTargetのAPIを叩いてみたので備忘として残しておきます。REST APIとSOAP APIがありますが、今回はSOAP APIを使ってメール送信をしてみます。（現時点ではSOAP APIの方ができることが多いイメージ）

ExactTargetのSOAP APIのリファレンスは以下がオススメです。

herokuでRabbitMQ Bigwig試してみた

Tue, 01 Sep 2015 07:30:11 +0000

AMQPとかよくわかりませんが、herokuでRabbitMQ BigWigを試してみましたー。今回はPHPでRabbitMQのチュートリアルを試してみました。

AMQPに関しては以下のサイトが詳しいです。

AzureADのGraph API触ってみた

Mon, 31 Aug 2015 07:30:28 +0000

Azure Active DirectoryのGraphAPIを触る機会があったので、備忘として残しておきます。

Graph APIの利用にあたって、以下のサイトを参考にしました。

Salesforceのログインフロー試してみた

Mon, 31 Aug 2015 07:30:16 +0000

Salesforceの認証プロセスとして独自のログインフローを構築できるということで、Salesforceが公開しているパッケージを使って以下のチュートリアル（TOTPの2要素認証）に従って検証してみました。 Login-Flows - developer.force.com

ログインフローは以下のスライドも詳しいです！ 7 power night2014_kanbayashi

Salesforceを認証プロバイダとしてCognitoを使ってみる

Thu, 27 Aug 2015 07:30:49 +0000

Salesforceを認証プロバイダとしてAmazon CognitoでAWSのAPIを叩く方法を書いていきます！参考URLは以下。今回のソースやら設定方法は、ほぼこちらのパクリです。 Building an App Using Amazon Cognito and an OpenID Connect Identity Provider

Perlド初心者がYAPC gihyoレポーターをやってみた話

Tue, 25 Aug 2015 07:30:42 +0000

僭越ながら、YAPC::Asia Tokyo 2015のgihyoレポーターとして8/20, 21の2日間だけ参加させていただきました。「ブログを書くまでがYAPC」ということなので、ブログに書かせていただきます！

Mailgun触ってみた

Mon, 24 Aug 2015 08:30:35 +0000

今回はSendGridと並んで有名なメール系サービスのMailgunに関して書いていきます！

SalesforceのSCIM叩いてみた

Mon, 24 Aug 2015 08:30:26 +0000

SalesforceがSCIMに対応しているということで試してみました！ SCIMの説明はこちらが詳しいです↓ SAML / OpenID Connect / OAuth / SCIM 技術解説 - ID&IT 2014 #idit2014

SalesforceのSCIMのリファレンスはこちら↓ System for Cross-domain Identity Management (SCIM) の使用

RequestBin使ってみた

Thu, 20 Aug 2015 00:54:53 +0000

最近Webhookの機能があるAPIを叩くことが多く、その都度、herokuで立てるか、ngrokでローカルアプリを持っていくか、IFTTT使うか、とか色々と検討していたのですが、RequestBinという便利そうなサービスを見つけたので使ってみました。

SendGrid触ってみた【Webhook編】

Thu, 20 Aug 2015 00:42:33 +0000

SendGridでは、メール送信だけでなく、受信メールを処理することも可能です。また、バウンスやUnsubscribe等のイベントに関する処理をすることも可能です。これらの処理をするのにメール受信やイベントが発生したときに、任意のエンドポイントにHTTPでデータを送信するWebhookの仕組みを使います。

SendGrid触ってみた【メール送信編】

Thu, 20 Aug 2015 00:27:42 +0000

メールサービスのSendGridを触ってみました。今回はSendGridのメール送信の機能について書いていきます。

SendGridでメールを送信するにはSMTPを使うSMTP APIとHTTPを使うWeb APIの2つの方法があります。

Yahoo!ウォレット FastPay触ってみた

Mon, 17 Aug 2015 00:46:30 +0000

Web決済サービスであるYahoo!ウォレット FastPayを触ってみたので備忘として残しておきます！サービスの利用（開発者側）にはYahoo!IDが必要になります。

課金・決済方法には都度の決済と、継続課金の2つの方式があります。

ExecuteAnonymousによるデバッグログの取得

Sun, 16 Aug 2015 22:52:42 +0000

Salesforceで検証用途等で任意のコードを実行させたい場合は、ExecuteAnonymousのAPIを使うことになりますが、SOAP APIだとHTTPリクエストのボディを以下のようにして呼び出すことが出来ます。

Talend触ってみた【Salesforceからエクスポート編】

Fri, 14 Aug 2015 10:42:19 +0000

前回はローカルのExcelファイルからSalesforceへインポートしてみたので今回はSalesforceからデータをエクスポートして、Excelファイルに格納してみます。

Talend触ってみた【Salesforceにインポート・基本編】

Thu, 06 Aug 2015 10:42:39 +0000

今更感ありますが、ETLツールのTalendが気になったので触ってみましたー

今回はExcelのファイルを読み込んで、Salesforceに

INSERT, UPDATE, DELETE, UPSERTする基本的なフローを試してみます。

Talendのインストール方法や基本的な使い方は以下のサイトが詳しいです。

Talendのススメ：無償で使えるオープンソースETL:Talend Open Studio の使い方

1. ジョブの作成

リポジトリタブのJob Designsを右クリック→ジョブの作成をクリックします。

テキトーな名前でジョブを作成します。

2. Excelのメタデータの定義

リポジトリタブのExcelファイルを右クリック→Excelファイルの作成をクリックします。

テキトーな名前を設定して、「Next」をクリックします。

読み込むExcelファイルを選択して、シートパラメータの設定で

任意のシートを選択します。読み込まれると右下に読込結果がプレビューされます。

設定が完了したら、「Next」をクリックします。

列名として先頭行を設定にチェックをいれて、「Next」をクリックします。

全てStringにしてFinishをクリックします。

3. コンポーネントを設置

まず、作成したExcelメタデータをJobDesigner上に、ドラッグアンドドロップします。

作成するコンポーネントの種類を聞かれるので"tFileInputExcel"を選択します。

そうすると、tFileInputExcelのコンポーネントが作成されます。

次にSalesforceのコンポーネントを設置します。

PaletteからtSalesforceOutputを選択してドラッグアンドドロップでコンポーネントを作成します。

Apexで文字コード変換

Sun, 02 Aug 2015 21:16:28 +0000

Apex内で生成した文字列は文字コードがUTF-8であるため

以下のようなコードだと添付ファイルは全てUTF-8で作成されます。

String result = 'あいうえお漢字カタカナ';
Attachment att = new Attachment();
att.Body = Blob.valueOf(result);
att.Name = 'hoge.txt';
att.parentId = '001A000000rJ9he';
insert att;

そこで、Apexのみを使ってUTF-8以外の文字コードのファイルを作成するには

以下のように書くことで実装できます。

※パーセントエンコーディングされる文字列のみ含む前提です。

String result = 'あいうえお漢字カタカナ';
String encodedResult = EncodingUtil.urlEncode(result, 'Shift-JIS').replaceAll('%','');

Attachment att = new Attachment();
att.Body = EncodingUtil.convertFromHex(encodedResult);
att.Name = 'hoge.txt';
att.parentId = '001A000000rJ9he';
insert att;

ポイントとしては以下のとおりです。

Apexで任意の文字コードのバイト列を直接取得するメソッドがない。
EncodingUtil.urlEncodeを使えばASCII等のURIとして利用できる文字種以外は指定の文字コードでパーセントエンコーディングされた文字列を取得できる。
パーセントエンコーディングされた文字列はバイト列の16進数表記なので convertFromHexでバイト列に戻せる。

利用出来る文字コードですが、おそらくJavaで利用できるものはOKだと思われます。

サポートされているエンコーディング

パーセントエンコーディングされない文字列は予め正規表現等で処理しておく必要があります。

また、エンコーディングに失敗すると、失敗した文字列が「？」に変換されるようなので

任意の文字列が文字コード変換後に任意のエンコーディングに

対応しているかどうかの確認も可能です。

（予め「？」自体の文字列を取り除いてからEncodingUtil.urlEncodeでバイト列取得する感じ）

参考URLはコチラ↓

memo: Force.com ： VF 画面から CSV ファイルをアップロードし、内容を画面に表示したい（ファイル文字コード Shift_JIS 編）

oauth2-server-phpでOAuth2.0 Providerを実装してみた。

Sun, 02 Aug 2015 20:07:08 +0000

OAuth2.0 Providerを実装したく、OSSを色々と巡ってみて

bshaffer/oauth2-server-phpが使いやすそうだったので触ってみましたー。

Box API叩いてみる【Webアプリ統合編】

Sat, 01 Aug 2015 22:07:19 +0000

今回はBox APIのWebアプリ統合機能を試してみます。

Webアプリ統合とは、BoxのWebアプリに対する拡張機能になります。

BoxのWebアプリ上で任意のファイルで　[その他オプション＞その他の操作]　から

ファイルに応じたアクションをすることが可能になります。

SalesforceだとSend To Chatterという、BoxのファイルリンクをChatter投稿するような

アプリケーションが公開されています。

参考URL→https://box-content.readme.io/docs/box-web-application-integrations

0. Webアプリ統合の仕組み

BoxのWebアプリで、[その他オプション＞その他の操作]　からアプリを選択すると

以下のようなプロンプトが表示されます。

このプロンプトでOKを押下すると任意のエンドポイントにHTTPリクエストが飛ばされ

エンドポイント側でHTTPリクエストに応じた処理を行うことで

Boxのファイル情報を使って外部Webアプリ連携が出来るようになる仕組みです。

1. アプリケーションの設定

Boxのアプリケーションで「新しいWebアプリ統合を作成」ボタンをクリックします。

名前と説明は必須なので適当に入力します。

プロンプトのメッセージとプロンプトで入力する項目を設定します。

入力項目は必須ではないですが、入力値をコールバックのパラメータとして含めることができるため

入力項目を利用することで処理に柔軟性を持たせることが出来ます。

コールバック構成ではコールバック先のエンドポイントやコールバックの方式を指定します。

また、ユーザ体験の項目で「ポップアップが表示されます」を選択すると

プロンプトでOKを押したあとの処理が別ウィンドウ（or別タブ）を立ち上げて

そのウィンドウ内でiframe読み込み（ホスト側はboxのWebアプリ）で呼び出されます。

現時点ではiframe読み込みではGETリクエストになる仕様のようなので

RESTのURLパラメータ（Get）でしかパラメータを渡すことが出来ません。

「サーバ側でのみ実行されます」はBoxがサーバ間で通信をしてくれる方式になり

この場合はRESTのPostパラメータとXML, SOAPが利用できます。

※ポップアップでもPOSTリクエストをする、という記述があるのですが確認できず…

コールバックパラメータの指定の方法はWebhookのときと同じです。

パラメータの値にOAuth2.0のAuthorization Code（scopeは対象のファイルアクセス権限のみ）

やfileのBase64値を含めることができます。

Authorization Codeを含める場合は、リクエストを受け取ったコールバック先が

code値をaccess_token, refresh_tokenに変換する必要があります。

（仕組み上、State値を使ったCSRF対策が出来なさそうなのが、すこし不安）

Box API叩いてみる【ViewAPI編】

Fri, 31 Jul 2015 15:49:00 +0000

今回はBoxのView APIを叩いてみます。

View APIとはPDFやOfficeドキュメントをHTMLに埋め込んで表示するためのAPIになります。

HTMLに埋め込むためにはPDFやOfficeドキュメントをHTMLにコンバートする必要があります。

ドキュメントのアップロード（＆コンバート@バックエンド）

→ドキュメントを閲覧するためのセッション（有効期限）を作成

→発行されたセッションIDを使ってURLを生成し、iframe等で表示

というフローで実装することになります。

今回はApexでSalesforceの添付ファイルをコンバートし、外部公開用のURLを発行してみます。

参考URL→https://box-content.readme.io/docs/viewing-your-first-document

1. アプリケーションの作成

View API用のアプリケーションを作成します（Content APIとは別）

https://app.box.com/developers/services にアクセスして

「Boxアプリケーションの作成」をクリックします。

テキトーに入力して、アプリケーションを作成します。

アプリケーションの詳細を開くと、View APIキーというのがあるのでコレをコピります。

2. ドキュメントのアップロード

アップロードにはファイルそのものをアップロードするスタイルと

外部公開されているURLを指定するスタイルの2種類があります。

今回はファイルそのものをアップロードしてみます。

ファイルそのものをアップロードする場合はContent-Type: multipart/form-dataで

送信する必要があります。

Apexからバイナリデータをmultipart/form-dataで送る方法は以下の記事を参照。

Apexからmultipart/form-data形式で送信してみる。

サンプルはこちら↓。Authorizationヘッダには1のView APIキーを入れてください。

Attachment atch = [SELECT id, Body FROM Attachment WHERE id = '00PA000000gBAiI'];

HttpRequest req = new HttpRequest();
String tokenKey = 'Input Your Token';
String boundary = 'boundary';

req.setHeader('Authorization', 'Token ' + tokenKey);
req.setHeader('Content-Type','multipart/form-data; boundary=' + boundary);
req.setMethod('POST');
req.setEndpoint('https://upload.view-api.box.com/1/documents');

String body = '--'+boundary+'\r\nContent-Disposition: form-data; name="file"; filename="hoge.pdf";\r\nContent-Type: application/pdf\r\nContent-Transfer-Encoding: base64\r\n\r\n' + 
EncodingUtil.base64Encode(atch.Body) + '\r\n--' + boundary + '--';

req.setBody(body);
req.setTimeout(120000);

Http http = new Http();
HTTPResponse res = http.send(req);
System.debug(res.getBody());

curlだとこんな感じ

Apexからmultipart/form-data形式で送信してみる。

Fri, 31 Jul 2015 15:00:46 +0000

Apexからmultipart/form-data形式でHTTPリクエストを行うときは

自前でBodyをゴリゴリ書いていく必要があるのですが、その際にファイルなどのバイナリデータを

含めるときの対応に関して書いていきます。

パターン1: HTTP Request Bodyをテキストで送信

受信側（API提供側）でContent-Transfer-Encoding: base64に対応しているケースで利用可能です。

Apexだと以下のようなコードになります（Boxのサンプル）

Attachment atch = [SELECT id, Body FROM Attachment WHERE id = '00PA000000gBAiI'];

HttpRequest req = new HttpRequest();
String tokenKey = 'Input Your Token';
String boundary = 'boundary';

req.setHeader('Authorization', 'Token ' + tokenKey);
req.setHeader('Content-Type','multipart/form-data; boundary=' + boundary);
req.setMethod('POST');
req.setEndpoint('https://upload.view-api.box.com/1/documents');

String body = '--'+boundary+'\r\nContent-Disposition: form-data; name="file"; filename="hoge.pdf";\r\nContent-Type: application/pdf\r\nContent-Transfer-Encoding: base64\r\n\r\n' + 
EncodingUtil.base64Encode(atch.Body) + '\r\n--' + boundary + '--';

req.setBody(body);
req.setTimeout(120000);

Http http = new Http();
HTTPResponse res = http.send(req);
System.debug(res.getBody());

multipart/form-dataの形式でBase64エンコードしたバイナリデータをBodyに載せただけで

Apex Connector Framework触ってみた。

Fri, 31 Jul 2015 11:46:04 +0000

いつの間にか、Apex Connector Framework(Custom Adapter)が

Dev組織で利用できるようになっていたので触ってみました！

Lightning ConnectはSalesforce環境から外部のデータにアクセスする機能で

別Salesforce組織のデータや、ODataに対応したAPI経由でデータを取得し

あたかもSalesforceのオブジェクトであるかのように扱うことが出来ます。

今回のリリースではApex Connector Framework(Custom Adapter)が利用できるようになりました。

これを使うと、閲覧するデータが別Salesforce組織のデータだったり、ODataに対応していなくても

Apexから取得できる手段であればガバナを超えない範囲において

様々なデータでも取得できるようになり、Salesforceのオブジェクトのような

振る舞いを持たせることができます。

今回はBoxのファイルデータを閲覧する外部データソースをApex Connector Frameworkを使って

定義し、SalesforceからBoxのファイル一覧を取得してみます。

参考URL→https://developer.salesforce.com/blogs/engineering/2015/05/introducing-lightning-connect-custom-adapters.html

1. Connectionクラスを作成

サンプルは以下の通り。

global class BoxDataSourceConnection extends DataSource.Connection {
 private DataSource.ConnectionParams params;
 global BoxDataSourceConnection(DataSource.ConnectionParams connectionParams) {
 this.params = connectionParams;
 }
 
 override global List<DataSource.Table> sync() {
 List<DataSource.Table> tables = new List<DataSource.Table>();
 List<DataSource.Column> columns;
 columns = new List<DataSource.Column>();
 columns.add(DataSource.Column.text('Name', 255));
 columns.add(DataSource.Column.text('Type', 255));
 columns.add(DataSource.Column.text('ExternalId', 255));
 columns.add(DataSource.Column.url('DisplayUrl', 255));
 columns.add(DataSource.Column.number('Size', 18, 0));
 columns.add(DataSource.Column.text('CreatedAt', 20));
 tables.add(DataSource.Table.get('Entries', 'Name', columns));
 return tables;
 }
 
 override global DataSource.TableResult query(DataSource.QueryContext context) {
 if (context.tableSelection.columnsSelected.size() == 1 &&
 context.tableSelection.columnsSelected.get(0).aggregation == DataSource.QueryAggregation.COUNT) {
 List<Map<String,Object>> rows = getRows(context);
 List<Map<String,Object>> response = DataSource.QueryUtils.filter(context, getRows(context));
 List<Map<String, Object>> countResponse = new List<Map<String, Object>>();
 Map<String, Object> countRow = new Map<String, Object>();
 countRow.put(
 context.tableSelection.columnsSelected.get(0).columnName,
 response.size());
 countResponse.add(countRow);
 return DataSource.TableResult.get(context, countResponse);
 } else {
 List<Map<String,Object>> filteredRows =
 DataSource.QueryUtils.filter(context, getRows(context));
 List<Map<String,Object>> sortedRows =
 DataSource.QueryUtils.sort(context, filteredRows);
 List<Map<String,Object>> limitedRows =
 DataSource.QueryUtils.applyLimitAndOffset(context,
 sortedRows);
 return DataSource.TableResult.get(context, limitedRows);
 }
 }
 
 override global List<DataSource.TableResult> search(DataSource.SearchContext context) {
 List<DataSource.TableResult> results = new List<DataSource.TableResult>();
 for (DataSource.TableSelection tableSelection : context.tableSelections) {
 results.add(DataSource.TableResult.get(tableSelection, getRows(context)));
 }
 return results;
 }
 
 private List<Map<String,Object>> getRows(DataSource.ReadContext context) {
 HttpRequest req = new HttpRequest();
 req.setHeader('Content-Type', 'application/json; charset=UTF-8');
 req.setEndpoint('callout:Box/2.0/folders/0/items?fields=name,created_at,size,type');
 req.setMethod('GET');
 
 Http http = new Http();
 HTTPResponse res = http.send(req);
 Utility.sendErrorMail(req.getBody());
 List<Map<String, Object>> results = new List<Map<String, Object>>();
 Map<String, Object> response = 
 (Map<String, Object>)JSON.deserializeUntyped(res.getBody());
 
 for (Object item_obj : (List<Object>)response.get('entries')) {
 Map<String, Object> item = (Map<String, Object>)item_obj;
 Map<String, Object> row = new Map<String, Object>();
 row.put('Name', item.get('name'));
 row.put('Type', item.get('type'));
 row.put('CreatedAt', item.get('created_at'));
 row.put('Size', item.get('size'));
 row.put('ExternalId', item.get('id'));
 row.put('DisplayUrl', 'https://hoge.example.com');
 results.add(row);
 }
 return results;
 }
}

sync, query, searchを実装すればOKで、

Box API叩いてみた【イベント通知編】

Mon, 27 Jul 2015 00:54:21 +0000

前回に引き続きBox APIを叩いていきます。

今回はBox Content APIのイベント通知機能について説明していきます。

Box Content APIではファイルのアップロードや削除等の各イベントの発生に対して

任意の処理を実行することが出来ます。

イベント発生の都度、任意のエンドポイントに通知するWebhookの方法と

イベントのストリームをロングポーリングして取得する方法の2つを利用することが出来ます。

Box API叩いてみた【ContentAPI編】

Sun, 26 Jul 2015 18:32:30 +0000

BoxはDropbox的なストレージサービスで、Businessプラン以上は容量無制限だったり

文書の暗号化が標準サポートだったりする、エンプラ向けなサービスになります。

ということで、今回はBoxのAPI（ContentAPI）の使い方を説明していきます！

SalesforceからBox APIを叩くサンプルを作っていきます。

1. アプリケーションの設定

OAuth2.0を利用するので、twitterやfacebook等のようにアプリケーションを設定します。

developersのサイトでログインします。

boxアカウント持っている場合は、MyAppsからログインして

持っていない場合はSignUpで無料の開発者用のアカウントを作成する必要があります。

ログイン後、初めてアプリケーションを作成する場合は以下の画面が表示されるので、

そのまま「はじめに」をクリックします。（これ日本語訳が…）

アプリケーション名を設定して、「アプリケーションの作成」をクリックします。

ラジオボタンは「Boxコンテンツ」のままでOK。

完了すると以下の画面になるので、そのまま「アプリケーションの構成」をクリックします。

そうすると、アプリケーションの詳細画面が表示されます。

色々と設定できるのですが、大事なところはOAuth2パラメータの部分になります。

BoxのAPIの認証はOAuth2.0のAuthorization Code Grantになるので

redirect_uriを設定し、client_id、client_secretをメモっておきます。

redirect_uriに関しては必須項目になりますがURI形式であればOKなので

https://localhostとかを入力して「アプリケーションの保存」で設定を保存します。

2. Salesforceの設定

ApexのSDKもあるみたいですが（dhoechst/ApexBox）、今回はNamed Credentialを使って叩いてみます。

OAuth danceをイチから実装しなくて良いから楽なんですよねー。

ということで、以下のように認証プロバイダを設定します。

承認エンドポイントURL　→　https://app.box.com/api/oauth2/authorize
トークンエンドポイントURL　→　https://app.box.com/api/oauth2/token
コンシューマ鍵と、コンシューマの秘密 →　それぞれ1のアプリ作成時にメモったclient_id, client_secret

と、それぞれ値をセットします。

発行された「コールバックURL」はBoxのアプリケーションのredirect_uriにセットしておきます。

Named Credentialは以下のように設定。

onelogin/php-samlを触ってみた

Sun, 28 Jun 2015 16:31:22 +0000

SAMLのSPとなるようなアプリケーションが簡単に作れるかどうか、という技術検証で

onelogin/php-samlを触ったので使い方をメモってみましたー。

今回はSalesforceをIdP、phpのアプリをSP（ローカル環境）として

ソースに付随されているサンプルのアプリを動かしてみます。

1. インストール

php使いの人にはお馴染みのComposerを使ってインストールします。

Windowsの場合はChocolateyだと何故か上手く行かなかったので、

本家からインストーラでインストールした方が良いかもしれないです。

$ composer init

からの　composer.jsonに"onelogin/php-saml": “master-dev” を追加

{
 "name": "hoge/php",
 "authors": [
 {
 "name": "hoge",
 "email": "hoge@example.com"
 }
 ],
 "require": {
 "onelogin/php-saml":"master-dev"
 }
}

からの

$ composer install

でvenderディレクトリ配下にインストールされます。

2. 証明書の設定

SP側の証明書を設定します。

certsフォルダに秘密鍵と証明書を作成します。

$ cd php-saml/certs
$ openssl genrsa 2048 > sp.key
$ openssl req -new -key sp.key > sp.csr
$ openssl x509 -days 3650 -req -signkey sp.key < sp.csr > sp.crt

3. settings.phpの設定

まずdemo1ディレクトリ配下のsettings_example.phpをコピーしてsettings.phpを作成します。

settings.phpの中身は以下の通り。

<?php
 $spBaseUrl = 'https://localhost/php-work/vendor/onelogin/php-saml'; //php-samlへのURLをセット

 $settingsInfo = array (
 	'strict' => true,
 	'debug' => true,
 'sp' => array (
 'entityId' => $spBaseUrl.'/demo1/metadata.php',
 'assertionConsumerService' => array (
 'url' => $spBaseUrl.'/demo1/index.php?acs',
 ),
 'singleLogoutService' => array (
 'url' => $spBaseUrl.'/demo1/index.php?sls',
 ),
 'NameIDFormat' => 'urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified',
 ),
 'idp' => array (
 'entityId' => 'https://hoge.my.salesforce.com',
 'singleSignOnService' => array (
 'url' => 'https://hoge.my.salesforce.com/idp/endpoint/HttpRedirect',
 ),
 'singleLogoutService' => array (
 'url' => '',
 ),
 'x509cert' => '', //現時点では未設定でOK
 ),
 'security' => array (
  'authnRequestsSigned' => true,
 )
 );

$spBaseUrlにはphp-samlへのURLをセット。

EmbulkのSalesforce outputプラグインを作ってみた。

Tue, 23 Jun 2015 00:26:49 +0000

EmbulkというOSSが非常に気になっていた＆Salesforceのoutputプラグインが無かったので、勉強がてら作ってみました。↓

tzmfreedom/embulk-output-salesforce

今回は備忘としてoutputプラグインの作り方と、embulk-output-salesforceの使い方を書いていきます！ Output Pluginの作成は以下のURLを参考にしました。

Java で Embulk Output Plugin を書く - Qiita

ちなみに、ソースコードを全て読んだわけではない＆読んだところも合っているか怪しいので、多少間違いが有ると思いますがご了承願います。

outputプラグインの作り方

テンプレートの作成

プラグインはJavaかRubyで書くことが出来ます。今回はJavaを使いました。プラグインのテンプレートは以下のコマンドで作成できます。

embulk new java-output {プラグイン名}

これでGradleベースのプロジェクトが自動生成されます。あとはsrc/main/java/org/embulk/outputにあるJavaファイルを書いていけばOK。

設定ファイルのキー値の設定

Taskクラスを継承したPluginTaskクラスにキー値と属性を指定し

ConfigSource#loadConfig(PluginTask.class)

で実際の設定を取得します。

PluginTaskにはannotationで属性を指定します。任意入力の項目の場合はOptional型で定義します。未指定時のデフォルト設定値はConfigDefaultアノテーションで定義します。文字列のデフォルトを定義する場合は@ConfigDefault(""hoge"")のようにエスケープが必要。

処理の流れ

OutputPluginの処理の流れだけに着目すると

OutputPlugin#transaction

→OutputPlugin#open（→TransactionalPageOutput#add …）

→OutputPlugin#cleanup

といったフローになります（自信なし）

TransactionalPageOutput

OutputPlugin#openではTransactionalPageOutputを継承したクラスを戻り値とします。 openはタスクの数だけ呼ばれるっぽいので、fileのinputプラグインを使って2つのファイルを処理する場合は、openが2回呼ばれて、TransactionalPageOutputのサブクラスのインスタンスが2つ作成されます。

TransactionalPageOutput#addでは引数のPageに実際のレコードが渡されるので、PageをPageReaderに読ませて、PageReaderではスキーマに応じた全カラムに対して処理を行うことになります。100桁くらいの3000行のデータを入れたら、一回のadd呼び出しで110件ちょっとのレコードが格納されていました。

pageReader.getSchema().visitColumns(…)の部分が全カラムに関する処理になり、引数にはColumnVisitorを継承したクラスを入れます（利用がワンタイムなので匿名クラスにしてます）。ColumnVisitorではカラムのデータ型に応じた処理を記載していきます。

Salesforceの場合はTimeStampだけ注意しておけばOKで、pageReaderで取得できるTimeStampの型はorg.joda.time.DateTime型であるため、wscを利用する場合は、データ型をjava.util.Calendar型やjava.util.Date型に変換する必要があります。wscはデータ型によってSOAPのxsi:typeを書き換えるので、SObject#addFieldで入れるObject型は注意が必要です。

テストの方法

pluginのテストの方法としては大きく2つあり、1つ目は実際のembulkコマンドに作ったプラグインを食わせる方法、もう1つはembulkのクラスを使ってJava内で実行するやり方です。

1つ目は

gradlew classpath

からの

embulk run -I ./embulk-output-salesforce/lib config.yml

を実行すればプラグインの挙動を確認できます。

2つ目はembulk runでやってることをJavaのコードを書いて実現するやり方です。

参考URLはこちら→Embulkプラグインのテストを楽にやりたい - 今日もプログラミング

embulk-output-salesforceの使い方

基本的には以下のようなoutputの定義を設定ファイルに書けばOKです。

out:
 type: salesforce
 username: hoge@example.com
 password: fuga
 sobject: Account

ログインからデータ入力まで全てSOAP APIを使ってます。内部的にはカラム名＝API参照名としてデータを格納しているので、inputプラグインのfileを使う場合、inputには以下のように記述します。

Fiddlerを使ってEclipseとData Loaderをトラッキング

Sun, 21 Jun 2015 23:01:46 +0000

今更ながらEclipseのforce.com IDEやData Loaderが

どのAPIをどのタイミングで叩いているかが気になったので

Fiddlerのプロキシを噛ませてネットワーク通信をトラッキングしてみました。

Fiddlerの証明書のインストール

JavaのキーストアにFiddlerのルート証明書をインストールします。

まず、Fiddlerのルート証明書をFiddlerからエクスポートします。

Fiddlerを起動し、メニューのTools＞Fiddler Optionsをクリックします。

HTTPSのタブでExport Root Certificate to Desktopボタンをクリックします。

そうすると、デスクトップにFiddlerRoot.cerの名前で証明書がエクスポートされます。

これを以下のコマンドでJavaのキーストアにインポートします。

<JDK_Home>\bin\keytool.exe -import -file C:\Users<Username>\Desktop\FiddlerRoot.cer -keystore FiddlerKeystore -alias Fiddler

パスワードを聞かれるので、適当なパスワードをセットします。

Eclipseの設定

eclipse.iniの行末に以下の2行を追記します。pathはFiddlerKeyStoreを作った場所をセット。

-Djavax.net.ssl.trustStore=C:/path/to/FiddlerKeystore
-Djavax.net.ssl.trustStorePassword=hogefuga

これでeclipse.exeを起動し、プロキシの設定をします。

ツールバーのWindow＞Preferencesをクリックして

GeneralのNetwork Connectionsを開きます。

Fiddlerが起動している状態でNativeを選択すると

以下のように127.0.0.1:8888を向いている状態になります。

これでEclipseのHTTP/HTTPS通信をFiddlerでトラッキングできます。

Data Loaderの設定

以下のコマンドでData Loaderを起動します。

"C:\Program Files (x86)\salesforce.com\Data Loader\Java\bin\javaw.exe" ^
-Djavax.net.ssl.trustStore="C:/path/to/FiddlerKeyStore" ^
-Djavax.net.ssl.trustStorePassword=hogefuga ^
-jar "C:\Program Files (x86)\salesforce.com\Data Loader\dataloader-30.0.0-uber.jar"

Data Loaderに同梱されているJavaを使わないとバージョンの差異等でエラーになる可能性があります。

あとは、起動後のData Loaderのプロキシ設定をすればOK。

Olingo + Lightning ConnectでODataに触れてみた

Sun, 24 May 2015 09:50:14 +0000

SalesforceのSummer15のリリースでLightning Connectが利用できるようになったようなので

ODataの勉強がてら触ってみましたー。

Lightning Connectは任意のOData Providerが提供するODataサービスを使って

Salesforceから外部データをCRUDできますよーっていう機能。

OData自体はインターフェースが仕様に準拠していれば裏はなんでもOKっていう

HTTP版ODBC的なプロトコルです。

ODataに関しては以下のリンクが詳しいです。

OData って何？

SFDCでのLightning Connectの設定に関しては以下のリンクが詳しいです。

Lightning Connectを手軽に試してみる « TerraSky Tech Blog

Salesforce連携のためのOData入門

今回は自前でOData Providerを作って、それに対してSFDCから接続してみます。

以下のリンクが自前でクライアント、サーバ側を構築する際のライブラリになります。

Libraries · OData - the Best Way to REST

今回はJavaのApache Olingo Libraryを使ってサンプルをベースにOData Providerを作っていきます。

※ちなみにOData全然知らないので解説で所々間違いが有ると思いますのでご注意を！

0. 準備

JDKとかmavenとかインストールしておきます。

1. サンプルのmavenプロジェクトを作成

SFDCでは現時点(2015/05/15)ではOData v2.0にしか対応していないので

v2.0のチュートリアルに従って進めていきます。

まず、Sample Project Setupに従って以下のmvnコマンドを実行します。

mvn archetype:generate \
 -DinteractiveMode=false \
 -Dversion=1.0.0-SNAPSHOT \
 -DgroupId=com.sample \
 -DartifactId=my-car-service \
 -DarchetypeGroupId=org.apache.olingo \
 -DarchetypeArtifactId=olingo-odata2-sample-cars-service-archetype \
 -DarchetypeVersion=RELEASE

プロジェクトがいい感じに作成されたら、ビルドします。

cd my-car-service
mvn clean install

そうするといい感じにtarget内にwarが出来上がるので

Cocos2d-JSを触ってみた【BGM再生・キー入力・アニメーション・衝突判定】

Sat, 14 Mar 2015 12:28:21 +0000

今回もCocos2d-JSを色々と弄ってみます。

1. BGM再生

いつも通りresディレクトリ内に音声ファイルをぶちこんで、src/resource.jsを修正します。

var res = {
  ...
  hoge_mp3 : "res/hoge.mp3",
  ...
}

あとはsrc/app.jsのLayerのctorに以下のコードを追記するだけで音楽が再生されます。

cc.audioEngine.playMusic(res.hoge_mp3, true); //BGM
cc.audioEngine.setMusicVolume(0.5); //音量の調整

ちなみに、効果音再生は

cc.audioEngine.playEffect(res.se01_wav);

って感じで行けます。

2. キー入力受付け

以下のようにcc.eventManagerにキーボード入力に対するイベントリスナーを追加するだけ。

cc.eventManager.addListener({
 event: cc.EventListener.KEYBOARD,
 //キー入力したとき
 onKeyPressed: function(keyCode, event){
 if (keyCode == 37) {
 //左
 } else if (keyCode == 38) {
 //上
 } else if (keyCode == 39) {
 //右
 } else if (keyCode == 40) {
 //下
 }
 },
 //キーを離したとき
 onKeyReleased: function(keyCode, event){

 }
}, this);

あとは各キーコードに応じた処理をfunction内で定義すればOK。

3. アニメーション

RPGの歩行アニメーション的な永続的なアニメーションの場合は以下のようにして処理を書きます。

画像一枚32px * 32pxで横3縦4で配置されるキャラチップ画像を想定しています。

var sprites = [];
sprites.push(new cc.SpriteFrame(res.actor_png, cc.rect( 0, 0, 32, 32)));
sprites.push(new cc.SpriteFrame(res.actor_png, cc.rect(32, 0, 32, 32)));
sprites.push(new cc.SpriteFrame(res.actor_png, cc.rect(64, 0, 32, 32)));
sprites.push(new cc.SpriteFrame(res.actor_png, cc.rect(32, 0, 32, 32)));
var action_down = new cc.RepeatForever(new cc.Animate(new cc.Animation(sprites, 0.2)));

this.sprite.runAction(action_down);

永続的なアニメーションなので、ループする画像のパターンを定義する必要があって

それがspritesの配列部分になります。

1→2→3→2→1→2→…と続くので1→2→3→2のループを定義しています。

キー入力とうまく組み合わせて、キャラの方向を検知して

アニメーションパターンを都度runActionで変更してあげればRPGっぽいキャラ移動が出来るようになります。

4. 衝突判定

前回やったタイルマップを使えば衝突判定を簡単に実装できます。

“レイヤー＞タイル・レイヤーの追加"からレイヤーを追加します。

レイヤーの名前はcollisionとかにしてください。

collisionレイヤーの衝突判定を付けたいところに適当なタイルセットで塗っていきます。

わかりやすくするために黒とかの単色タイルセットを作って塗っていくと

後で衝突設定した場所がわかりやすいです。

塗り終わったらレイヤーの透過度を0にします。

Salesforce Communityでカスタムドメイン使ってみる。

Sat, 14 Mar 2015 12:14:44 +0000

Salesforce Communityのカスタムドメインがいつの間にかSSL対応出来るっぽかったので試してみました。

1. Communityの作成

テキトーにドメインを決めて作成します。

2. CSRを発行

セキュリティのコントロール＞証明書と鍵の管理　から証明機関署名証明書の作成をクリックして

証明書の情報を入力。

保存後に「証明書署名要求のダウンロード」でCSRをダウンロード

3. 認証局の署名付きSSL証明書を発行

ここは各認証局毎の手順が異なるので、詳細は各認証局のサイトを参照してください。

4. 認証局に発行してもらった証明書をSFDCに取り込む

2で登録した証明書の「署名済み証明書の更新」から発行してもらった証明書を取り込みます。

5. ドメインの追加

ドメイン管理＞ドメイン　でカスタムドメインを登録します。

証明書は1-4で登録したものを選択。

DNSのCNAMEレコードで

{カスタムドメイン}→{カスタムドメイン}.{組織IDのLowerCase}.live.siteforce.com

を作成するのもお忘れなく（これ作んないとドメイン登録できないです）

6. カスタムURLの追加

新規カスタムURLから登録を行います。

サイトはCommunityを選択。パスはそのままで。

これで、コミュニティのカスタムドメイン対応が完了します。

反映は少し時間がかかるかも？

Cocos2d-JSを触ってみた【画像表示・タイルマップ表示編】

Sun, 01 Mar 2015 20:12:09 +0000

前回は環境構築を行ったので今回は画像を表示したり、タイルマップを表示したりしてみます。

1. ディレクトリ構成

プロジェクトを作成すると、こんな感じでファイル展開されます。 ``` CMakeLists.txt frameworks index.html main.js project.json res src tools ``` CMakeLists.txt→ビルドの設定ファイル

frameworks, tools→Cocos2d-JSのAPIとかそういうのが格納されてるディレクトリ

res→リソース（画像とか音声ファイルとか）を格納するディレクトリ

src→プログラムのソースコードが格納されているディレクトリ

index.html→ゲームのHTMLファイル

project.json→ゲームのエンジンとかフレームレートとかの設定を行うJSONファイル

main.js→index.htmlから呼び出されるJSファイル。このJSファイルを起点にゲームが開始される。

ということで、基本的にはresディレクトリの中にリソースファイルを追加したり

src内でJavaScriptのソースコード書いたりするのが開発の基本的な流れになります。

2. 画像の表示

実際に画像を表示してみます！

まずは適当な画像を入手します。

今回はRPG的なモノを意識して↓からキャラチップ画像をダウンロードさせていただきました！

RPGツクール素材支部|臼井の会

用意した画像（今回はactor.png）をresディレクトリに格納します。

res/resource.jsに用意した画像のファイル名を追記します。

var res = {
 actor_png : "res/actor.png"
};

var g_resources = [];
for (var i in res) {
 g_resources.push(res[i]);
}

画像の設定が完了したので、画像を表示するコードをsrc/app.jsに書きます。

var HelloWorldLayer = cc.Layer.extend({
 sprite:null,
 ctor:function () {
 this._super();
 
 //画面サイズの取得
 var size = cc.winSize;
 //画像の表示
 this.sprite = new cc.Sprite(res.actor_png, cc.rect(0, 0, 32, 32)); //左上から32px*32pxで画像切り出し
 this.sprite.attr({x: size.width/2 , y: size.height/2}); //画像位置の設定
 this.addChild(this.sprite);
 }
});

var HelloWorldScene = cc.Scene.extend({
 onEnter:function () {
 this._super();
 var layer = new HelloWorldLayer();
 this.addChild(layer);
 }
});

ルートディレクトリのmain.jsは以下のように書き換えます。

cc.game.onStart = function(){
 cc.view.adjustViewPort(true);
 cc.view.setDesignResolutionSize(640, 480, cc.ResolutionPolicy.SHOW_ALL);
 cc.view.resizeWithBrowserSize(true);
 //load resources
 cc.LoaderScene.preload(g_resources, function () {
 cc.director.runScene(new HelloWorldScene());
 }, this);
};
cc.game.run();

index.htmlを叩くと、インクルードされているmain.jsが呼び出され

Salesforceのデータバックアップ用Dockerfile作ったので公開してみた

Sun, 15 Feb 2015 13:16:37 +0000

~~Apex書くのに飽きたため~~業務の効率を上げるため、Salesforceの各オブジェクトごとの

レコードをCSVでフルバックアップするスクリプト書いてDockerfileにしてみました。

S3の設定をすれば各csvをgzip化して、S3にアップロードするようにもなっていたり。

DataLoader使えば良いじゃん説がありますがJavaとXMLの設定がめんどかった

＋herokuみたいなone offでクリーンなエクスポートをしてみたかったってのが動機っす。

完成品はこちら。

Dockerhubにも登録してます→tzmfree/sfdc-exportjs

使い方は、ログ用のディレクトリを作成して

mkdir /var/log/sfdc-exportjs

環境変数セットしたDocker走らせるだけ

docker run --rm -t \
-e SFDC_USERNAME="hoge@example.com" \
-e SFDC_PASSWORD="fuga123" \
-e SFDC_LOGINURL="https://login.salesforce.com" \
-e SFDC_TARGETOBJECT="Account;Contact" \
-e SFDC_LIMIT="500000" \
-e S3_BUCKET="backup" \
-e AWS_ACCESS_KEY_ID="AKI***************" \
-e AWS_SECRET_ACCESS_KEY="********************" \
-e MODE="parallel" \
-v /var/log/sfdc-exportjs:/var/log/sfdc-exportjs \
tzmfree/sfdc-exportjs /sbin/my_init -- ./export.sh

ボリュームで指定したディレクトリ（ホスト側に作ったディレクトリ）にログとかCSVファイルが格納される仕様っす。

CSVファイルをごにょりたい場合はdocker run後の処理でそのCSVを煮るなり焼くなりすればOK。

スケジュール起動したい場合はホスト側のcrondでdocker runごとブン回してください。

以下はDockerfileの備忘っす。

Dockerfileの書き方

MAINTAINERは作った人の名前。

FROMはベースとなるDockerイメージ。

今回ベースとしているphusion/baseimageはDocker使う時のハマりどころを色々と回避してくれてる

ベースイメージで、sshdとかcrondとかも初期装備されてる便利なDockerイメージ。

Dockerfileでよく使うのはRUNとADD。

RUNは実行するコマンドで大体パッケージインストールやgit clone等のセットアップ系を行います。

ADDは実行ディレクトリ配下にある特定のファイルをアップロードする操作で

今回はエクスポート担当のNode.jsスクリプトをアップロードしてます。

Dockerhubへの登録とか

今回はgithubやbitbucketにpushしたら自動的にビルドしてDockerhubにアップロードしてくれる

Automated Buildという機能を利用しました。

設定は超簡単で、Dockerhubにログイン後にAdd Repositoryのボタンから

Automated Buildを選択して

gitのサービス選んで

リポジトリ選んで

Cocos2d-JSを触ってみた【環境構築編】

Wed, 21 Jan 2015 00:50:57 +0000

Cocos2d-xというクロスプラットフォームなゲーム開発が可能な

フレームワークがあるということで色々と触ってみました。

プロダクトとしてCocos2d-xとCocos2d-JSの２つありますが、

C++, Luaで書けるのがCocos2d-x

JavaScriptで書けるのがCocos2d-JS

という棲み分けになります。

どの実行環境向けにコンパイルできるかにも違いが有り、

Webゲームを作りたい場合はCocos2d-JSを選択することになります。

今回はみんな大好きJavaScriptで書けるCocos2d-JSで

環境構築＋プロジェクト作成＋コンパイルまでやってみます！

実行環境はWindows7です。

今回の参考URLはこちら↓

Cocos2d-JSを動かすまでの手順 | ゆめみスタッフブログ -ゆめログ-

Cocos2d-x / Cocos2d-JS のインストール〜起動まで - Qiita

cocos2d-x - Cocos2d-JS を触ってみた - Qiita

1. 環境構築

公式サイトからCocos2d-JSの最新版（現在v3.2）をダウンロードします。

ダウンロードしたら展開して、適当なフォルダに展開します。

Python 2.7も必要なのでこちらもインストールします。

Windowsの場合は本家から2系の方をダウンロードして実行して適当に場所にインストール。

インストール後はPythonのインストールディレクトリにパスを通しておきます。

Cocos2d-JSの実行スクリプトにもパスを通す必要があるので

<Cocos2d-JSをインストールしたPATH>\tools\cocos2d-console\binを環境変数PATHに追加します。

また、プログラムのコンパイルを行う為にCocos2d-JSの設定をする必要があります。

$ cd {Cocos2d-JSをインストールしたPATH}
$ python setup.py

を実行すると対話式で設定をすることが出来ます。

Androidのコンパイルをする場合はNDKとAndroid SDKのルートディレクトリをそれぞれ指定します。

コンパイルする場合（Web版だとリリースバージョン作る場合）は

antのルートディレクトリを指定する必要があります。つまり、コンパイルする場合はantも必須です。

これで環境構築が完了しました！

$ cocos

と叩いて、コマンドが動かない場合はPythonやCocos2d-JSへのPATHが通ってない可能性が高いです。

2. プロジェクト作成

cocosコマンドで新しいプロジェクトを作成することができます。

$ cocos new {アプリ名} -l js -d .

作成するとこんな感じでファイルが作成されます。

Dokku Alternative触ってみる。

Tue, 20 Jan 2015 01:47:49 +0000

Dokku AlternativeというOSSを使うと、Dockerを利用して

herokuみたいなPaaSを作れるということなので試してみましたー。

Dokku Alternativeは本家のDokkuに色々と機能を追加したOSSみたいです。

参考URLはこちら↓

Dokku Alternative·個人用PaaSにどうぞ。Dokkuに便利な機能を追加 MOONGIFT

Herokuのように簡単に使えるDockerベースのPaaS | KRAY Inc

Dockerを使ったミニPaaSのdokkuをパワーアップさせた「Dokku Alternative」を試す - さくらのナレッジ

今回はまっさらなVMに入れてみます。

1. Ubuntuインスタンスを立ち上げる

今回はDigitalOceanで立ち上げました。

スペックはメモリ512MBの一番安いプランで、OSはUbuntu 14.04x64を選択。

Dokku-altはUbuntu 14.04 LTSにしか対応してないっぽいです。

立ち上げたら、セキュリティ系の諸々の初期設定をした後、スワップファイルの設定をしてください。

これをしないとメモリ不足でインストールがコケます。

$ sudo dd if=/dev/zero of=/swap bs=1M count=2048
$ sudo mkswap /swap
$ sudo swapon /swap

設定したら、以下のコマンドでswap領域が有効になっているかを確認

$ cat /proc/swap

/etc/fstabにも登録しておきます

/swap swap   swap    defaults   0 0

2. Dokkuのインストール

インストールは超簡単で以下のコマンドを実行するだけ。

$ sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/dokku-alt/dokku-alt/master/bootstrap.sh)"

インストールが成功すると初期設定用のサーバが立ち上がるので

http://{サーバーのIP or ホスト名}:2000にアクセスして設定を行います。

IPアドレスだとアプリに対してサブドメイン形式のURLをアサインできません。

Rapiroで遊ぶ【Chatterで操作編】

Sat, 17 Jan 2015 22:20:38 +0000

前回はRapiroをカスタマイズして無線LAN対応させたので

今回は実際にWebと接続して任意のクライアントからRapiroを操作できるようにします！

方法としてはRapiro（Raspberry Pi）を起点にPush型にするか（RapiroをWebサーバ化する）

Pull型でRapiro側からWebにデータを取りに行くかの2パターンがありますが、

今回はPull型でデータ取得先にコマンド入力のデータがあれば

シリアル経由でRapiroを操作するフローで構築してみます。

cron使えば言語／フレームワーク問わないのですが

入出力がプラガブルで拡張性の高いhubot使えば色々便利そうだったので今回はコレを使います。

hubotと言えば以前にhubot-chatterを作ったのでChatter使ってRapiroを操作してみます！

Chatterに命令文書いたらrapiroが動く感じです。

1. Node.jsをRaspberry Piにインストール

Raspberry Piでapt-getでパッケージインストールしたら、yaomanインストールあたりの

エラーでハマったのでPi用のバイナリを使ってインストールします。

$ curl -O http://nodejs.org/dist/v0.10.28/node-v0.10.28-linux-arm-pi.tar.gz
$ sudo tar --strip-components 1 -xzvf node-v0.10.28-linux-arm-pi.tar.gz -C /usr/local

2. hubotのインストール&ボット作成

まずはhubotのインストール

$ sudo npm install -g yo generator-hubot

hubotの作成

$ mkdir hubot
$ cd hubot
$ yo hubot
$ npm install hubot-chatter

3. hubotスクリプトの作成

こんな感じのスクリプトをscripts/test.coffeeに設置

SerialPort = require("serialport").SerialPort
serialPort = new SerialPort("/dev/ttyAMA0", {
 baudrate: 57600
}, false)

serialPort.open (error)->
 if error
 console.log('failed to open: #{error}')
 else
 console.log('open')

module.exports = (robot) ->
 robot.respond /RAPIRO (.*)$/i, (msg) ->
 command = msg.match[1]
 switch command
 when "stop"
 serialPort.write("#M0")
 when "forward"
 serialPort.write("#M1")
 when "back"
 serialPort.write("#M2")
 when "right"
 serialPort.write("#M3")
 when "left"
 serialPort.write("#M4")
 when "green"
 serialPort.write("#M5")
 when "yellow"
 serialPort.write("#M6")
 when "blue"
 serialPort.write("#M7")
 when "red"
 serialPort.write("#M8")
 when "push"
 serialPort.write("#M9")
 else
 serialPort.write("#M0")

さらに起動用のシェルファイルも作成

Rapiroで遊ぶ【カスタマイズ編】

Sun, 04 Jan 2015 19:25:04 +0000

今回はRapiroをRaspberry Piでさらにカスタマイズしていきます！

Rapiroの拡張というよりは、機能拡張したRaspberry PiをRapiroに載せる感じです。

今回の参考サイトは以下になります↓

[Raspberry Pi搭載系]

RAPIRO に Raspberry Pi を搭載する | アンドロイドな日々

RAPIRO: The Humanoid Robot Kit for your Raspberry Pi by Shota Ishiwatari — Kickstarter

[Bluetooth&PS3コントローラで遠隔操作系]

RapiroをPS3のDUALSHOCK3で動かしてみる | Makuake（マクアケ）NOTE クラウドファンディングブログ

シリコンハウスへようこそ:RAPIRO製作日誌～無線化への道～ Raspberry pi 搭載編続章 bluetooth設定

工作と小物のがらくた部屋: Raspberry Pi で Dualshock3 (Bluetooth接続ゲームコントローラ）

[カメラモジュール系]

How to install / use the Raspberry Pi Camera | The Pi Hut

Raspberry Pi メモ (23) - カメラモジュールの使い方

無線LAN対応

Webに接続できるようにしないと、外部から遠隔操作したり

Webサービスとつないだりできないので、まずは無線LANに対応させます。

Raspberry PiにUSBの無線LANのドングルを繋いで色々と設定すればOKです。

Rapiroで遊ぶ【組み立て編】

Sat, 03 Jan 2015 16:11:33 +0000

RapiroというArduino互換の基板が搭載されたロボットを購入したので組み立ててみました！

Rapiroは、Arduino互換の基板とRaspberry piに接続できるインタフェースを持つため

拡張性が高く、組み立てもドライバーだけで出来るお手軽なロボットキットです。

組み立て方に関しては公式のドキュメントを参考にしましたが、

個人的にここは注意したほうが良い！という点を備忘録として記載します。

準備

Rapiro自体は45,000円で手に入りますが、

動力源となる単三型のニッケル水素充電池やACアダプタは別途用意する必要があります。

公式ドキュメントではeneloopやEnergizer Rechargeを利用するように記載されていますが

evoltaでも一応動きました。

色んなところ歩かせたいとかの機動力重視の場合は乾電池一択になるんですが

電池の消費が激しく（満充電状態で45-90分稼働）、充電もそれなりに時間がかかるので

ACアダプタの方が手軽で良いです。

Raspberry Pi + カメラモジュールで監視するとか、音声読み上げたり音声認識させたり等の

据え置き系重量級ロボにする場合は、ACアダプタ一択ですかね。

また、組み立てにはドライバが必要です。

ドライバは軸が長く（全長15cmくらい？）トルクをかけやすい（＝グリップが太い）ものを使ってください。

Rapiroのネジは全てプラスのネジになるので

それなりに精密なドライバを利用したほうが良いと思います。

サーボモータのキャリブレーション

公式マニュアルの工程53でサーボモータの位置を初期位置にしますが、

こちらの作業は必ず満充電での乾電池 or ACアダプタで行ってください。

購入した直後の電池でも"充電済み"と一応書いてありますが

満充電状態ではなく、そのままでは正しく動かない可能性が有るので、充電する必要があります。

満充電状態であれば、工程53で軸がしっかり動いてサーバモータの初期位置が決まります。

私は満充電状態じゃない電池で動かしてしまったのですが

その状態でも一応モーターの駆動音がしたので

てっきり初期位置が決まったものだと勘違いしてました（実は軸が全く回っていなかったっぽい）。

初期位置決めがうまく行っていなくても、工程209のキャリブレーションで無理矢理調整できますが

大きな調整（例えば180度軸を回転させて初期位置を調整する等）はできません。

53以降の取り付け時には極力軸を回さないように組み立てていきますが

後で10-20度くらいの初期位置調整は可能なので

ちょっとぐらい軸が回ってもあまり気にしなくても良いです。

特に脚（2箇所）や指あたりは組み立て終わった後に、再度組み直すのが容易な箇所だったりするので。

ちなみに初期位置調整がうまくいってないと、以下のような残念な状態になりますｗ

頭が…。

電池が足りなくなってくるとRapiroが捻れる

乾電池の場合は電池が足りなくなってくると、電源を入れた瞬間にRapiroが急に捻れ始めます。

キャリブレーション中に電池不足で捻れると、調整がうまくいっていないのか

電池に問題があるのか切り分けづらいので、キャリブレーション中も満充電の状態で行ってください。

Rapiroの操作方法

キャリブレーション時に標準ファームウェアをインストールしますが、

このファームウェアに前進、後退、旋回、目を光らせる等の基本動作が入っているので

ファームウェアを書き換えることなくRapiroを操作することが可能です。

Arduino互換なのでArduino IDEで独自のファームウェアを書いてインストールすることも可能です。

標準ファームウェアを利用した操作では、シリアル通信でRapiroに命令（コマンド）を送って

操作するのが基本になります。

Rapiro単体の場合（Raspberry Piなし）はPCとRapiroをUSBでつないでシリアル通信を行います。

Rapiroのカスタマイズ

Raspberry PiとRapiroのArduino互換の基板をシリアル接続できるように設計されているので

Raspberry Piを使った拡張が容易です。

2015

Thu, 01 Jan 2015 00:00:00 +0900

ApexからAmazon Lambda叩いてみる。

Sun, 14 Dec 2014 01:02:43 +0000

Amazon Lambdaというすんばらしいサービスがプレビュー提供されたということでApexから触ってみた。

1. Lambda側のfunctionを書く

今回はChatter投稿するようなスクリプトを書いてみた。

var jsforce = require('jsforce');
var username = "test@example.com";
var password = "hogefuga";
var loginUrl = "https://login.salesforce.com";

exports.handler = function(event, context) {
 var conn = new jsforce.Connection({
 loginUrl : loginUrl
 });

 var chatter_body = {
 body: {
 messageSegments: [{
 type: 'Text',
 text: "hello " + event.content + "!!"
 }]
 }
 };
 conn.login(username, password, function(err, res) {
 conn.chatter
 .resource("/feeds/record/" + event.parent_id + "/feed-items")
 .create(chatter_body, function(err, result) {
 console.log(result);
 console.log(err);
 context.done(null, 'chatter de lambda');
 });
 });
};

上記スクリプトをindex.jsとして保存する。

必要なパッケージもローカルインストールしておく。今回はjsforceのみ。

npm install jsforce

2. 作成したLambda functionをアップロードする

node_modulesと対象のスクリプトファイルをまとめてzipファイルにする。

$ zip -r lambda.zip index.js node_modules

で、アップロードする。

Function Name, Description→適当に

Function Code→生成したZipファイルをアップロード。File nameとHandler nameはそのまま。

Role name→Functionの実行コンテキストになるロールを指定する。Create/Select Roleで作成・指定すればOK。

Advanced Settings→一回あたりのFunction実行の利用可能なメモリやタイムアウト時間を適当にセット。

3. 動作確認

作成したLambda Functionが正しく動作するかを確認する。

まずは確認対象のLambda Functionを選択してEdit/Testをクリック。

CasperJSでSalesforceのレコード詳細画面を自動キャプチャ

Sun, 02 Nov 2014 22:39:55 +0000

プロファイルのキャプチャを取るのにChromeExtensionとかでキャプチャを手動で取っていたのを

何とかしたかったのでCasperJSで自動化してみました。

CasperJSはPhantomJSのユーティリティで、ヘッドレスなブラウザをAPI経由で操ってテストしたり

キャプチャを取ったりすることが出来るツールになります。

今回は

SOQLを発行してレコードの一覧を取得
1で取得したレコードIDを元に各レコード詳細画面に遷移後、キャプチャを取得

という流れでキャプチャを取ってみます。

作成物はこちら。

ちなみにSOQLで取得できて、取得したIDを使ってhttps://{ドメイン}/{取得したID}のURLで

アクセスできるオブジェクトであれば何でも取得できます（プロファイルのキャプチャもOKです）。

1. 指定オブジェクトのSalesforceIDの一覧を取得

nodejsでjsforce使って指定のレコードIDの一覧を取得します。

# レコード一覧を取得するcoffeescript
program = require("commander")
program
 .version('0.0.1')
 .option('-u, --username <username>', 'Salesforce Username')
 .option('-p, --password <password>', 'Salesforce Password')
 .option('-e, --env [env_type]', 'Salesforce Environment', 'prod')
 .option('-o, --output [outputfile]', 'OutputFile')
 .option('-q, --query [soql]', 'Query', 'SELECT id FROM Profile')
 .parse(process.argv);

fs = require("fs")
jsforce = require('jsforce')
endpoint = if program.env =='test' then 'https://test.salesforce.com' else 'https://login.salesforce.com'
connectOptions = {
 loginUrl : endpoint
}
conn = new jsforce.Connection(connectOptions)
conn.login program.username, program.password, (err, res) =>
 if err
 return console.error(err)
 conn.query(program.query)
 .stream()
 .pipe(process.stdout)

クレデンシャルや実行SOQLをパラメータで与えるためcommanderを利用。

Azure Active DirectoryでTwitterにシングルサインオンしてみる。

Sun, 02 Nov 2014 13:47:56 +0000

Azure Active Directoryネタです。

今回はAzure Active DirectoryでTwitterにシングルサインオンをしてみます。

通常、Twitterやfacebookなどサービスにシングルサインオンというと

これらのWebサービスをIdP(OP)としてOAuth、OpenID Connectによる認証連携をイメージしますが

Azure Active Directoryの場合は、AzureAD自体がIdPになり

TwitterなどのWebサービスがSPとなるような構成になります。

1. TwitterのギャラリーアプリをAADに追加

まずは対象のDirectoryを選択

アプリケーションを選択して、追加をクリック

今回はギャラリーからアプリを追加

Twitterのアプリケーションを選択

追加するとこんな画面が表示される

シングルサインオンの構成をクリックしてパスワードシングルサインオンになっていることを確認

2. ユーザの割り当てを実行

Twitterのギャラリーアプリ設定画面から、「ユーザの割り当て」を選択してユーザ一覧にアクセスし

対象のAzureADユーザに対して割り当てを行う。

割り当てでは「ユーザの代わりにTwitter資格情報を入力する」にチェックを付けて

紐付けるTwitterのユーザ名／パスワードを入力する。

これで、AzureAD側の設定は完了です。

3. アクセスパネルからシングルサインオンを行う

https://myapps.microsoft.comにアクセスしてAzureADユーザでログインを行うと

以下のようにシングルサインオン用のパネルが表示されます。

複数のディレクトリに属すAzureADユーザの場合は右上のメニューからディレクトリを選択することが可能。

また、各ブラウザのAzureAD用のプラグインがインストールされていない場合は

パネルをクリックするとプラグインのインストール画面に遷移します。

hubotのchatterアダプタを作ってみた。

Sun, 26 Oct 2014 18:15:38 +0000

Web+DB PRESSとか読んでてhubotを使ったChatOps的なところが非常に興味深かったので

chatterで出来ないかなーと思ってadapterを探したものの

用途にマッチしたものが無かったので自分で作ってみました。（npmデビュー作ｗ）

↓↓↓

tzmfreedom/hubot-chatter

hubotとは

hubotとはgithub社が開発したボットのフレームワークで

外部サービス／インターフェースと連携可能なadapterと呼ばれるプラガブルなモジュールと

ボットの動作を規定するスクリプトによって様々なボットを簡単に開発することができます。

hubotに関してはこちらが詳しいので、ご参考ください↓

第1回 Hubotとは何か：GitHub社謹製！ bot開発・実行フレームワーク「Hubot」｜gihyo.jp … 技術評論社

チャットボットでチーム開発効率化入門（1）：GitHub製フレームワークHubotの概要とインストール、チャットアプリと連携する基本的な使い方 (1/2) - ＠IT

で、今回はこのhubotのadapterを作り方とhubot-chatterの使い方を簡単に紹介します。

作り方の参考サイトはこちらが詳しいです↓

hubot adapterの作り方 - おみブロZ

adapterの作成方法

hubotのadapterの作成方法ですが上記リンクの通り

現時点(2014/10/26)では作成方法のドキュメント等がありません。

READMEの記載通り、ソースコードを読んで作っていく必要があります。

とはいえ、作り方は超簡単でsrcディレクトリ内にcoffeescriptでアダプタを書いてあげればOKです。

ざっくり書くとこんな感じ↓

{Robot, Adapter, TextMessage, Response} = require 'hubot'

# アダプターを継承
class HogeAdapter extends Adapter
 run: ->
 #ここで外部からデータを受け取ってscriptにデータを渡す。
 send: (envelope, strings...) =>
 #scriptからのレスポンスはここで受け取って、処理を行う。
 reply: (envelope, strings...) ->

exports.use = (robot) ->
 new HogeAdapter robot

hubotを起動すると指定したadapterのrunメソッドが実行されるので、

Azure Active DirectoryとSalesforceのSSO【ギャラリーアプリ編】

Sat, 27 Sep 2014 12:44:10 +0000

IDMaaSシリーズ第三弾として今回はAzure Active Directory(AAD)をやってみます。

AADはざっくり言うと認証連携のIdPのクラウドサービスで

任意のアプリケーションに対してOpenID ConnectやSAML、WS-Federation等の

認証連携プロトコルを使ってシングルサインオンができるようになるサービスです。

また、これらの認証連携プロトコルのRP/SPとして対応していない特定のサービスに対しても

シングルサインオンができるような仕組みを持っています。

既存のActive DirectoryからAADに同期することで既存のActive Directoryを

ユーザーリポジトリとして利用することも可能です。

ということで、今回はAADを使ってSalesforceとのシングルサインオンをやってみます！

Azure Active Directoryに関する説明は以下のサイトが詳しいです↓

Windows Azure Active Directoryことはじめ（1/8）：CodeZine

Azure ADとIdentity管理

クラウド時代のActive Directoryの使い方 - IT、IT製品の情報なら【キーマンズネット】

Tutorial: Azure AD Integration with Salesforce - TechNet Articles - United States (English) - TechNet Wiki

1. Microsoft Azureポータルで対象のAADを選択

まずはアカウントにログインしてポータルトップへアクセスし

Active Directory＞既定のディレクトリを選択します。

ドメイン変更等の理由で規定のディレクトリを利用しない場合は

下メニューの”新規”からAzure Active Directoryを新規に追加します。

Auth0だとドメイン名の32文字の文字数制限があったりするので

外部アプリの制限に引っかかった等の場合は新しくAADを作成してください。

2. 作成したディレクトリにユーザを追加

Azure Active Directory用のユーザを作成します。

このユーザに対してログインすることで他のサービスにシングルサインオンすることができます。

werckerでforce.comなアプリをCIする。

Sat, 27 Sep 2014 11:59:49 +0000

前回はスタンダードにpythonなアプリをwerckerを使ってCIしましたが、

今回はforce.comなアプリをCIしたいと思います。

pushからwerckerが動き出すまでは前回と同様。

werckerが動き出すとantでテスト走らせるっていうだけのシンプル構成。

1. リポジトリの構成

treeするとこんな感じ。

├── build.properties
├── build.xml
├── lib
│   └── ant-salesforce.jar
├── src
│   ├── classes
│   │   ├── S3Common.cls
│   │   ├── S3Common.cls-meta.xml
│   │   ├── S3CommonTest.cls
│   │   └── S3CommonTest.cls-meta.xml
│   ├── objects
│   │   └── Account.object
│   └── package.xml
└── wercker.yml

リポジトリ内にant-salesforce.jarを入れてますがこれだとリポジトリが大きくなるので

jarは別サーバに置いておいて、wercker.ymlの設定でビルド時に取ってくる構成の方が効率的かと思います。

build.properties

sf.serverurl = https://login.salesforce.com

build.xml

<project name="Sample usage of Salesforce-CI Ant tasks" default="checkDeploy" basedir="." xmlns:sf="antlib:com.salesforce">
 <property file="build.properties" />
 <property environment="env" />
 
 <!-- Build / TestResult never actually saves to the server -->
 <target name="checkDeploy">
 <sf:deploy username="${env.USERNAME}" password="${env.PASSWORD}" serverurl="${sf.serverurl}" deployRoot="src" checkOnly="true" runAllTests="true" />
 </target>
</project>

ユーザ名やパスワードはうっかりgitに上げると面倒なことになるので環境変数を使うようにします。

werckerでPython/FlaskなアプリをCIする。

Thu, 25 Sep 2014 23:45:44 +0000

CI as a Serviceに触れてみよう第一弾として今回はwerckerを触ってみます。

巷ではTravisCIやCircleCIが有名ですが、privateでフリーなgitリポジトリを利用したかったので

bitbucketが利用できるwerckerを選択！

werckerを使うと…

リモートリポジトリにソースをpush

→リモートリポジトリがwerckerに対してWebフック

→werckerが対象のgitリポジトリからソースをダウンロード

→werckerがgitリポジトリ内にある設定ファイル（wercker.ymlなど）からCI用のVMを作成し

必要なモジュールインストール及びビルド、テストを自動実行

→必要に応じて自動デプロイを実施

というフローでCIしてくれます。

今回はbitbucketに対してソースをpushすると自動的にwerckerでテストを走らせて

通ったらOpenShiftに自動デプロイをする、というのをやってみます。

1. Webアプリを準備

今回は（も？）Python/Flaskでやってみます。

ソースをtreeした結果はこんな感じ

├── requirements.txt
├── wercker.yml
└── wsgi
 ├── __init__.py
 ├── application
 ├── ciapp.py
 ├── templates
 │   ├── _index.html
 │   └── _login.html
 └── test_ciapp.py

対象のFlaskアプリのciapp.py↓

# -*- coding: utf-8 -*-
from flask import Flask, request, render_template

app = Flask(__name__)

@app.route("/")
def index():
 return render_template("_index.html")

@app.route("/login", methods=["GET", "POST"])
def login():
 if request.method == "GET":
 return render_template("_login.html")
 elif request.method == "POST":
 if request.form["username"] == "hoge" and request.form["password"] == "fuga":
 return "you are authorized"

 return "bad request"

if __name__ == '__main__':
 app.debug = True
 app.run()

Auth0でSocialSignOnやってみる。

Fri, 19 Sep 2014 00:14:56 +0000

Auth0とは認証基盤のクラウドサービスであるIDMaaSのサービスです（多分）

Auth0自体がRDBMSやLDAP、AD、SocialSignOn（OAuthやらOpenID Connect）やSAMLの

認証基盤のハブとなることで、利用アプリ側はプロトコル間の差異を気にすることなく

同一の方法で複数サービス、多様なプロトコルの認証基盤を利用することができます。

また、外部サービスをIdPとする以外にもAuth0自体にユーザリポジトリを持つことができたり

自分がホスティングしているDBサーバを認証基盤として利用することができます。

サーバサイドのソフトウェアインストールが必要になりますが、LDAP、ActiveDirectoryも利用可能です。

それ以外にもIPアドレスで認証できたりMicrosoftのIDMaaSであるWindows Azure Active Directoryを利用して

認証連携をすることも可能です。

また、ベータ版ですがMFAにも対応してるっぽいです。

ということで、今回はAuth0でSocialSignOnをやってみます。

参考サイトはこちら↓

Auth0で簡単ソーシャルログイン - フレクトのHeroku Lab

Herokuサンプル - ソーシャルログインサンプル

1. アカウント登録

https://auth0.com/ にアクセスして、アカウントを登録します。

github、Microsoft、Google+のアカウントでSignUpもできます。（こういうのなんて言うんだろ？SocialSignUp？）

2. アプリを作成

Apps/APIsで新しいアプリを作成します。

※後述のサンプルコードにClientIDやClientSecretが丸ごと記載されているので、ここでメモらなくてもOK。

3. SocialSignOnの設定

Connection＞Social からSocialSignOn対象のサービスを選択して設定を行います。

Auth0では各Webサービスに対する設定方法が非常にわかりやすくなっているので

対象のWebサービスを使ったこと無い人でも比較的簡単に設定できるのがGoodなところです！

以下はTwitterの設定画面で”How to obtain a Consumer Key?”のリンク先に設定方法が記載されています。

ここでは具体的な設定方法は割愛しますが、基本的にどのサービスでも

Webサービス側のアプリケーションに対してコールバックURLを設定して

Auth0でWebサービスのClientIDとClientSecretを設定する、という流れになります。

4. 認証基盤を利用するアプリケーションを設置する

SocialSignOnの設定が終わったら、あとはコードを書くだけ。

Auth0は各言語、各JSフレームワークでのサンプルが豊富で基本的にコピペして使い回せます。

2で作成したアプリケーションのQuickStartリンクを押下すると以下の画面に遷移します。

ApplicationTypeとPlatformをそれぞれ選択すると超親切なサンプルコードが表示されるので

無限リストビュー

Tue, 16 Sep 2014 23:45:12 +0000

ここでクイズ。

Salesforceのリストビューは1オブジェクトにつき最大何件まで保持することができるでしょうか？？

1,000
10,000
100,000
根性が続くまで
Salesforceに怒られるまで

ということで検証してみました。

ちなみにリストビューの件数制限に関してはSFDCのhelpには記載されておりません（多分）

検証方法1. Eclipseでメタデータ直接いじる

Eclipseで対象オブジェクトのメタデータを抽出

→適当なスクリプトでリストビューのXMLをガツっと入れて保存

と最も手軽に試せる方法。

Pythonだとこんな感じのスクリプトを書く

for num in range(0, 10):
 print("""<listViews>
<fullName>TestView%09d</fullName>
<filterScope>Everything</filterScope>
<label>TestView_%09d</label>
</listViews>""" % (num, num))

これを使って生成したテキストを***.objectの中にガツっと入れてSave to Serverする。

1万件くらいの保存だと5-10分程度で保存可能。

ただし10万件とかになるとEclipseのヒープサイズの方でエラーになってくるので

この方法ではリストビューの限界を調査するのが難しそう。ということで一旦別の方法を検討。

検証方法2. CRUDベースのMetadataAPIを使ってチマチマ入れる

CRUDベースのMetadataAPI使って最大10件ずつこまめに作成する方法です。

Pythonだとこんな感じのスクリプトを組めばOK。

SessionIDはログイン状態のCookieから奪うなり何なりして取得してください。

#!/usr/bin/env python
# -*- coding: utf-8 -*-
import urllib.request
import urllib.error

BASE_URL = "https://na12.salesforce.com" #対象の環境のベースURLを入力

f = open("create_metadata_base.xml")
payload = f.read().replace("{{sessionId}}", "Input SessionID")
f.close()

f = open("listview_base.xml")
base = f.read()
f.close()


#ユーザ属性の取得
try:
 max_size = 100000
 temp_lists = []
 for i in range(max_size):
 temp_lists.append(base.replace('{{number}}', '%09d' % i))
 if i%6 == 5 or i == max_size-1:
 req = urllib.request.Request(
 url=BASE_URL + "/services/Soap/m/28.0",
 headers={
 "SOAPAction": '""',
 "Content-Type": "text/xml"
 },
 data=payload.replace("{{body}}", "".join(temp_lists)).encode(),
 method="POST"
 )
 res = urllib.request.urlopen(req)
 print(res.read().decode())
 temp_lists = []
except urllib.error.HTTPError as e:
 print(e.read())
 print(e.reason)

OpenAMでHOTP認証してみる【GoogleAuthenticator編】

Thu, 24 Jul 2014 22:29:26 +0000

前回はOpenAMでOATHのTOTP認証をやりました。

今回はGoogleAuthenticatorでHOTP認証をやってみます。

※設定は前回とほとんど同じなので省略しまくってます。

HOTPの仕組みに関しては以下のリンクが詳しいです。

OSSによるアイデンティティ管理（2）：不正ログインを食い止めろ！ OpenAMで認証強化 (2/2) - ＠IT

参考URL↓

Configure OpenAM to use OATH for Strong Authentication - OpenAM - Confluence

1. SecretKeyの生成

任意の秘密鍵を生成し、それぞれのbase16エンコード、base32エンコードの値を取得します。

2. OpenAMの設定

アクセス制御＞対象のレルム＞データストア＞embedded　を選択して

LDAPユーザ属性のroomNumberを追加します。

アクセス制御＞対象のレルム＞認証　のモジュールインスタンスでOATHの設定を変更

前回からの変更点は

使用するアルゴリズム→HOTP

カウンタ属性名→roomNumber

の部分です。

3. LDAPの設定

前回同様にLDAPサーバに接続して対象のユーザのtitle属性とroomNumber属性を追加・変更します。

秘密鍵のbase16エンコード値をtitleに入力して、roomNumberは0を入力してください。

4. Google Authenticatorの設定

今回のQRコードのURL値は以下の形式になります。

otpauth://hotp/{適当なユーザ名}@{適当なドメイン}?secret={1で作成したbase32エンコードした秘密鍵}

これをGoogle AuthenticatorのQRコードリーダで読み込ませるか、以下のように手入力でセットします。

あとは前回同様、ログイン画面でOTPコードを送信すれば認証完了となります。

OpenAMでTOTP認証してみる。

Wed, 23 Jul 2014 21:51:50 +0000

OpenAMの多要素認証シリーズとしてTOTP認証をやってみます。

TOTP認証に関しては以下のサイトが詳しいです。

OSSによるアイデンティティ管理（2）：不正ログインを食い止めろ！ OpenAMで認証強化 (2/2) - ＠IT

今回は以下のサイトに従って設定していきます。

Google Authenticator and OpenAM - OpenAM - Confluence

1. SecretKeyの生成

適当なSecretKeyを決めてbase16エンコード、base32エンコードした値を生成します。

例えば"test12345abcdefg"というキーであれば

base16エンコード値→74657374313233343561626364656667

base32エンコード値→ORSXG5BRGIZTINLBMJRWIZLGM4======

となります。

各エンコード値は以下のサイトで簡単に生成できます。

http://online-calculators.appspot.com/base16/

http://online-calculators.appspot.com/base32/

※秘密鍵を第三者に渡すことになるので検証用にお使いください。

2. OpenAMの設定

アクセス制御＞対象のレルム＞データストア＞embedded　を選択し

LDAPユーザ属性にtitleとdescriptionを追加します。

次に　アクセス制御＞対象のレルム＞認証　のモジュールインスタンスでOATHをクリックします。

OATHを以下のように設定します。

今回は検証用なので秘密鍵は8桁にしちゃってますが、本番用はもっと大きい桁数（デフォルト32桁）にしてください。

秘密鍵の属性にtitle、最終ログイン時間属性にはdescriptionを割り当てます。あとはデフォルト通り。

※検証用なので属性はテキトーです。

また、TOTPのタイムステップ感覚とタイムステップ数ですが

今回利用するGoogle Authenticatorはトークンの生成間隔が30秒なのでデフォルト通りでOKです。

最後に認証連鎖を設定します。

こんな感じの認証連鎖を作成↓

組織認証設定を変更

3. LDAPの設定

OpenAMのデータストア（LDAP）にアクセスしてtitle属性に秘密鍵を格納します。

LDAPにアクセスする手段としてGUIツールのApache Directory Studioを利用します。

OpenAMでHOTP認証してみる【メール送信編】

Tue, 22 Jul 2014 00:35:25 +0000

これまでOpenAMでシングルサインオンをするためのパターンをいくつか紹介しました。

シングルサインオンは「一回ログインすれば複数のサービスを利用できる」ことが利点ですが

反面、「攻撃者にログインされると複数サービスを利用されてしまう」という欠点もあります。

この欠点を補うのが「多要素認証」になります。

今回は多要素認証の一つであるHOTP認証をOpenAMでやってみたいと思います。

参考URLはこちら

OSSによるアイデンティティ管理（2）：不正ログインを食い止めろ！ OpenAMで認証強化 (1/2) - ＠IT

OpenAMが提供する様々な認証方式（1/4）：CodeZine

Netforest Developer’s Note - OpenSSOでワンタイムパスワード

Chapter 2. Defining Authentication Services

https://www.osstech.co.jp/_media/techinfo/seminar/openam-shibboleth.pdf

OpenAMの設定

アクセス制御＞対象のレルム＞認証　のモジュールインスタンスでHOTPをクリック。

今回はGmailのSMTPサーバを使うので以下のように編集。

ユーザ名/パスワードはそれぞれGmailのユーザ名/パスワードを入力する。

アクセス制御＞対象のレルム＞認証　の認証連鎖で新規の認証連鎖を作成

対象の認証連鎖の設定を以下のように編集します。

認証設定を以下のように変更します。

上記設定で/openam/UI/LoginでログインするときにはHOTPの認証連鎖設定が適用され

/openam/consoleでログインするときには通常のID/パスワード認証のみの設定が適用されます。

これにより、設定ミスによってadminがログインできない状態になることを防ぎます。

最後に　アクセス制御＞対象のレルム＞対象＞対象のユーザ　でメールアドレスを設定

動作確認

ログイン画面（/openam/UI/Login）でID/パスワード認証後、以下の画面が出てきます。

OTPコードの要求をすると対象のユーザ（ログイン失敗したユーザ）のメールアドレスに

OpenAMでSSO【OpenIG編】

Mon, 21 Jul 2014 00:07:26 +0000

今回はOpenAM+OpenIG+PolicyAgentなSSOをやってみます。

以下のような構成になります。

フローを簡単に説明すると

UserAgentがWebサーバにアクセス（初回）
Policy Agentがリクエストをインタラプト、Cookieが入っていないのでOpenAMに認証要求リダイレクト
OpenAMで認証後、Webサーバにリダイレクト
認証されている(=Cookieが入っている)のでPolicy AgentはCookie値をOpenAMに問い合わせて

ユーザ名/パスワードを取得

Policy Agentが取得したユーザ名/パスワードをヘッダに入れてOpenIGにリクエスト

（パスワードは暗号化されている）

OpenIGはログイン画面がリクエストされた時のみヘッダからユーザ情報を取得し、認証リクエストを行う

（通常のフォームPOSTを模倣する）

Webアプリは認証リクエストを受け取り、ユーザ認証実行後OpenIG・Policy Agent経由で

UserAgentにレスポンスを返して認証終了

といった感じです。

OpenIGはリクエストのプロトコルやURI、ヘッダ等の情報やフォワードしたHTTPリクエストに対する

レスポンスの正規表現マッチングを使って処理を分岐させたり

HTTPクライアントとして動かしたりできるリバースプロキシソフトウェアになります。

今回はOpenIGを使ってOpenAMで認証されたユーザ名/パスワードでWebアプリにSSOするフローをやってみます。

※本記事ではOpenAMのユーザ名/パスワード＝Webサイトのユーザ名/パスワードになることを想定しています。

参考URLは以下になります。

OpenAMによるシングルサインオン（２）リバースプロキシー編 - Tech-Sketch

OpenIG | LAJ技術ブログ

Chapter 5. Detailed Use Cases

Chapter 7. Tutorial On OpenAM Password Capture & Replay

Chapter 11. Configuration Templates

1. OpenIGのインストール

Javaのアプリケーションサーバで動作するらしいのでtomcat使ってやってみます。

ダウンロードはここから→https://forgerock.org/downloads/openig-builds/

展開したwarファイルをtomcatのルートに設置

$ mv {展開したwar} /var/lib/tomcat7/webapps/ROOT.war

tomcat実行ユーザのホームを/etc/passwdで調べて以下のディレクトリに設定ファイルを作成

$ touch {tomcat実行ユーザのホーム}/.openig/config/config.json

あとはconfig.jsonの設定ファイルを書き換えていくだけでOK。(3を参照)

2. OpenAMの設定

Policy Agent編でのPolicy Agentの仕事はトークンの検証のみで良かったのですが

今回はユーザ情報をOpenIGに送る必要がある（OpenIGからOpenAMのユーザ情報を取得できない）ことから

OpenAMでSSO【OpenID Connect編】

Sun, 20 Jul 2014 16:20:03 +0000

今回はOpenAMを使ってOpenID ConnectでSSOを実現したいと思います。

この方法だとPolicy Agentと同様にWebアプリの改修が必要になりますが

OpenID Connect準拠なのでセキュリティ等が担保されているのが利点です。

以下、参考URLになります。

OSSによるアイデンティティ管理（4）：OpenAMのOpenID Connectへの対応 (3/3) - ＠IT

Chapter 3. Using RESTful Web Services

Chapter 6. Configuring Policy Agent Profiles

Chapter 12. Managing OAuth 2.0 Authorization

SFDCにはOpenID ConnectのRP側の機能もあるので、SFDCとOpenAMをOpenID ConnectでSSOしてみます。

1. OpenAM側の設定

基本的に参考URL通りにやっておけばOKで

トップページからOAuth2の設定をクリックして作成

で、アクセス制御＞対象のレルム＞エージェント＞OAuth2.0クライアントでエージェントを作成

エージェントの名前がClientID、パスワードがClientSecretになります。

作成後に細かい設定ができます。

リダイレクトURI↓

スコープ↓

デフォルトのスコープ↓

OpenAMでSSO【Policy Agent編】

Sat, 19 Jul 2014 14:57:22 +0000

以前、OpenAMを使ってSAML2.0でSSOをする記事を書きましたが、SAML2.0を使ったSSOだとWebアプリケーション側が対応してないケースが多く、実装も困難であるため任意のWebアプリケーションに対するSSOの手段としてあまり適用できません。

ということで、今回から「OpenAMを認証プロバイダにして任意のWebアプリに対してシングルサインオン」をする方法に関して書いてみます！

Salesforceの代理認証SSOやってみる

Sun, 13 Jul 2014 23:33:38 +0000

SalesforceにはSalesforceへの認証を任意の認証サーバが行えるようになる代理認証機能があります。

これによって、Salesforceのパスワードではなく独自で認証基盤を運用することが可能になります。

ということで、代理認証SSOをやってみます！

今回はJava + tomcat + axisな代理認証SOAPサーバを立ててみます。

参考URL：

Web サービスを開発する: 第 1 回 Axis2 を使用して、コード・ファースト手法とコントラクト・ファースト手法で Web サービスを開発する

1. tomcat、axis、antのセットアップ

tomcatをインストールしてaxis2をダウンロード。

Binary DistributionとWAR Distributionの両方をダウンロードしてください。

WARの方はzip展開してtomcatのwebappsディレクトリに入れてインストールは完了。

Binaryの方はSalesforceのwsdlからjavaに変換するために利用します。

antはaarファイルの作成に利用します。

2. wsdlからサーバースタブを作成

Salesforceから代理認証用のwsdlを取得（設定＞開発＞API）

任意のディレクトリで以下のコマンドを実行。

{AXIS2_HOME}にはBinary Distributionのaxis2のパスを入れてください。

$ {Binary Distributionのaxis2のパス}\bin\wsdl2java.bat \
 -uri {wsdlへのパス}/AuthenticateService.wsdl -d adb -s -ss -sd -ssi -o .

これでサーバースタブが作成されます。

3. スケルトンクラスにロジックを追加

src\com\sforce\soap\authenticationディレクトリのSforceAuthenticationServiceSkeleton.java内の

ToDo: fill this with…のところにロジックを追加します。

今回はテキトーに認証してみます。

/**
 * SforceAuthenticationServiceSkeleton.java
 *
 * This file was auto-generated from WSDL
 * by the Apache Axis2 version: 1.6.2 Built on : Apr 17, 2012 (05:33:49 IST)
 */
package com.sforce.soap.authentication;
/**
 * SforceAuthenticationServiceSkeleton java skeleton for the axisService
 */
public class SforceAuthenticationServiceSkeleton implements SforceAuthenticationServiceSkeletonInterface{
 /**
 * Auto generated method signature
 * Are the supplied saleforce.com userId and password valid ?
 * @param authenticate0 
 * @return authenticateResult1 
 */
 public com.sforce.soap.authentication.AuthenticateResultE authenticate(
 com.sforce.soap.authentication.AuthenticateE authenticate0
 ) {
 //TODO : fill this with the necessary business logic
 AuthenticateResult result = new AuthenticateResult();
 Authenticate auth = authenticate0.getAuthenticate();
 Boolean isAuth =
 auth.getUsername().equals("hoge@fuga.com") && 
 auth.getPassword().equals("abcdef");
 
 result.setAuthenticated(isAuth);
 AuthenticateResultE resulte = new AuthenticateResultE();
 resulte.setAuthenticateResult(result);
 return resulte;
 }
}

パラメータのAuthenticateEクラスからユーザ名とパスワードとログイン要求元IPアドレスを取得して

SalesforceコミュニティでOpenID Connectやってみる【Authorization Code Flow編】

Thu, 10 Jul 2014 00:33:51 +0000

SalesforceをOPにしてOpenID Connectによるソーシャルログインが出来るということなので試してみた。

せっかくなのでSalesforceユーザではなく、コミュニティユーザでソーシャルサインオンをやってみます。

RP側はPython/Flaskで。

1. 接続アプリケーションの設定

いつもの接続アプリケーション。

今回はaccess_tokenを使ってUserInfo以外のAPIを叩かないのでid openid refresh_tokenをscopeに入れました。

2. RP側プログラムの作成

pythonのバージョンは3.3系。暗号化ライブラリとしてPyCryptoを使ってます。

# -*- coding: utf-8 -*- 
from Crypto.Hash import SHA256
from Crypto.PublicKey import RSA
from Crypto.Signature import PKCS1_v1_5
from Crypto.Util.number import bytes_to_long
from flask import Flask, request, session, render_template
from urllib.error import HTTPError
import urllib.request
import base64
import json
import time
import datetime
import random
import hmac

BASE_URL = "https://{community domain}"
CLIENT_ID = "input your client_id"
CLIENT_SECRET = "input your client_secret"
REDIRECT_URI = "input your redirect_uri"

def get_random_string(length):
 """
 ランダムな文字列を生成する
 """
 source_str = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ1234567890'
 return "".join([random.choice(source_str) for x in range(length)])

def b64d(b):
 """
 base64urlデコード
 """
 b += "=" * ((4 - len(b)) % 4)
 return base64.urlsafe_b64decode(b)
 
def b64e(b):
 """
 base64urlエンコード
 """
 return base64.urlsafe_b64encode(b).decode().replace("=", "")
 
def b64_to_long(b):
 """
 base64エンコードした文字列をロング型に変換
 """ 
 return bytes_to_long(b64d(b))

def get_rsa_publickey(jwt_header):
 """
 https://{sfdcドメイン}/id/keysから公開鍵を取得する。
 """
 kid = json.loads(b64d(jwt_header).decode())["kid"]
 req = urllib.request.Request(url=BASE_URL + "/id/keys") 
 res = urllib.request.urlopen(req)
 jsonMap = json.loads(res.read().decode())
 
 target_key = {}
 for key in jsonMap["keys"]:
 if key["kid"] == kid:
 target_key = key
 break
 modulus = b64_to_long(target_key["n"])
 exponent = b64_to_long(target_key["e"])
 return RSA.construct((modulus, exponent))
 
def validate_idtoken(jwt):
 """
 JWSの署名検証
 """
 jwt_array = jwt.split(".")
 jws_payload = jwt_array[0] + "." + jwt_array[1]
 #https://{sfdcドメイン}/id/keysから公開鍵の情報を取得
 key = get_rsa_publickey(jwt_array[0])
 #jws_payloadのSHA-256ハッシュ値と復号化した署名が一致しているかどうかを検証
 signer = PKCS1_v1_5.new(key)
 local_hash = SHA256.new(jws_payload.encode())
 return signer.verify(local_hash, b64d(jwt_array[2]))

def create_signature(json_map):
 """
 id,issued_atからSignatureを生成し署名を検証する
 """
 payload = json_map["id"] + json_map["issued_at"]
 signature = hmac.new(CLIENT_SECRET.encode(), payload.encode(), SHA256).digest()
 return base64.b64encode(signature).decode()

def get_idtoken(code):
 """
 id_token+access_tokenの取得
 """
 #access_tokenの取得
 token_req_param = {
 "grant_type" : "authorization_code",
 "client_id" : CLIENT_ID,
 "client_secret" : CLIENT_SECRET,
 "redirect_uri" : REDIRECT_URI,
 "code" : code
 }
 req = urllib.request.Request(
 url=BASE_URL + "/services/oauth2/token", 
 data=urllib.parse.urlencode(token_req_param).encode(),
 headers={"Content-Type" : "application/x-www-form-urlencoded"}
 )
 
 try:
 res = urllib.request.urlopen(req)
 return json.loads(res.read().decode())
 except HTTPError as error:
 print(error.reason)
 
 return {}
 
def get_userinfo():
 """
 ユーザ情報の取得
 """
 #access_tokenの取得
 req = urllib.request.Request(
 url=session["instance_url"] + "/services/oauth2/userinfo",
 headers={"Authorization" : "Bearer " + session["access_token"]}
 )
 
 try:
 res = urllib.request.urlopen(req)
 return json.loads(res.read().decode())
 except HTTPError as error:
 print(error.reason)
 
 return {}
 
app = Flask(__name__)
app.debug = True
app.secret_key = get_random_string(32)

@app.route("/")
def index():
 """
 Authorization Requestの為の初期ページ
 """
 request_param = {
 "response_type" : "code",
 "client_id" : CLIENT_ID,
 "redirect_uri" : REDIRECT_URI,
 "scope" : "id openid refresh_token",
 "state" : get_random_string(32),
 "nonce" : get_random_string(32)
 }
 session["state"] = request_param["state"]
 session["nonce"] = request_param["nonce"]
 authorization_url = BASE_URL + "/services/oauth2/authorize?" + urllib.parse.urlencode(request_param)
 return render_template("index.html", authorization_url=authorization_url)

@app.route("/callback")
def callback():
 """
 Authorization Requestに対するコールバックを受け取る
 """
 #state値が正しいかどうか確認
 if session["state"] != request.args.get("state"):
 return "invalid parameter error!!"
 #id_token(+access_token)の取得
 json_map = get_idtoken(request.args.get("code"))
 
 #signature検証
 if json_map["signature"] != create_signature(json_map):
 return "invalid parameter error!!"
 
 #id_tokenの検証
 if validate_idtoken(json_map["id_token"]):
 jwt_array = json_map["id_token"].split(".")
 jwt_claim = json.loads(b64d(jwt_array[1]).decode())
 
 now = int(time.mktime(datetime.datetime.now().utctimetuple()))
 exp = int(jwt_claim["exp"])
 #token有効期限の確認
 if now > exp:
 return "code is expired!!"

 if jwt_claim["nonce"] != session["nonce"]:
 return "invalid parameter error!!"

 signature = SHA256.new(json_map["refresh_token"].encode()).digest()
 #signature = SHA256.new(json_map["access_token"].encode()).digest() #at_hash
 #signature = SHA256.new(request.args.get("code").encode()).digest() #c_hash
 print(json_map)
 print(jwt_claim)
 signature = b64e(signature[:int(len(signature)/2)]).replace("=", "")
 #hash, issuer, audienceの確認
 if signature == jwt_claim["c_hash"] and jwt_claim["iss"] == "https://login.salesforce.com" and jwt_claim["aud"] == CLIENT_ID:
 session["id"] = jwt_claim["sub"]
 session["access_token"] = json_map["access_token"]
 session["instance_url"] = json_map["instance_url"]
 userinfo = get_userinfo()
 return "hello " + userinfo["name"] + "<br/>login is successful!!"
 
 return "validation error!!"


if __name__ == "__main__":
 app.run()

ArduinoからChatter投稿してみる【シリアル通信編】

Thu, 03 Jul 2014 00:08:23 +0000

前回はWeb proxyを介してChatter投稿しましたが、

今回はWebではなくシリアル通信でproxyとやりとりしたいと思います。

フローとしては

Arduinoから出力したデータをシリアル通信でPCにデータ転送

→データを受け取ったPC側のプログラムがデータを検知したらChatterに投稿

って感じです。

今回は光センサ（CdSセンサ）を使って、電気を消したらChatterに自動投稿されるというモノを作ってみます。

0. 準備

必要な物は以下になります。イーサネット関連がいらなくなるので前回より手軽です。

・Arduino Uno R3

・CdSセンサ

・ジャンプワイヤ、抵抗、ブレッドボード

1. 電子回路組み立て

回路は以下のようになります。今回はアナログ入力ピンを使ってます。

CdSセンサには光を当てると抵抗値が下がるという特徴があります。

また、V = R * I のオームの法則から

5(V) = (R1[CdSセンサの抵抗値:] + R2[右の抵抗値]) * I

となります。

CdSセンサの抵抗値によって電流値(I)が変わってきますが、全体としての電圧は5Vで固定です。

アナログ入力値は R2 * I でR2の値は固定なので、電流の値が大きい＝全体の抵抗値が少ないということから

センサに光を当てるとアナログ入力値が高くなり、光を当てないとアナログ入力値が低くなります。

今回はこの電気を消した時、つまりアナログ値が低くなったタイミングでArduinoからPCにシリアル通信をします。

実際につなぐとこんな感じ

2. Arduinoにプログラムを書き込む

アナログ入力値を読み込んで、しきい値を越えたらシリアル通信をするだけのシンプルなプログラム。

int val = 0;

void setup(){
 Serial.begin(9600);
}

void loop(){
 val = analogRead(0);
 if (val < 10) {
 Serial.println(val);
 delay(5000);
 }
 delay(10);
}

ArduinoからChatter投稿してみる【Web proxy編】

Tue, 01 Jul 2014 00:31:33 +0000

今回は、Arduino使ってWebにデータ飛ばしてみます！

ArduinoでWebにデータ飛ばす、となるとだいたいfluentdに投げて

elastic searchとkibanaでビジュアライゼーションみたいな感じの構成を取ることが多いと思いますが

今回はSalesforceに直接投げます。

直接投げると言っても、Arduino自体はSSLサポートしていないので

Web経由でプロキシを介して通信をする
シリアル通信経由でArduinoと直接つないでいるPCから通信をする
Arduino yunを使ってyunのLinux側のcurlで通信をする（ことが出来るらしい）

といった手段を取る必要があります。

今回は1の方法で”ボタンを押すとArduinoからChatterに投稿する”というモノを作ります。

参考サイト：

Qoosky - 電子工作でインターネットに無線接続して通信を行う (Arduino)

0. 準備

必要な物は以下になります。

・Arduino Uno R3

・Ethernet Shield

・ちびファイ（無線LANコンバータ）

・タクトスイッチ

・ジャンプワイヤとか抵抗とかブレッドボード

Arduino単体ではWebに飛ばせないのでEthenet Shieldを装着してください。

ちびファイは無くてもOKですが、無いとLANケーブルをArduinoに繋げるハメになり

配線がもどかしいので無線LANコンバータがあると非常に便利です。

電子回路関連はArduinoのスターターキットを買うと一式まとめて買えるのでオススメ。

1. 回路等の組み立て

回路は以下のようになります。スイッチ押したら電気通るだけの超シンプル構造です。

ちなみに、この図はfritzingを使ってます。回路図とか書くときは便利らしい。

実際はこんな感じになります。上のLANケーブルはちびファイに繋がってて、下はPCと繋がってます。

2. Arduinoにプログラムを書き込む

Arduinoのマイコンボードに以下のプログラムを書き込みます。

スイッチ押すとWeb ProxyにGETリクエストが飛びます。

#include <SPI.h>
#include <Ethernet.h>

const int BUTTON = 7;
int val = 0;
int old_val = 0;

//ethernetシールドのmacアドレス
byte mac[] = {0x**, 0x**, 0x**, 0x0F, 0x8B, 0x8A};

//Web proxyのIPアドレス
IPAddress server(192,168, 1, 2); 

EthernetClient client;

//http接続がclose状態であればtrue
boolean isClose = true;

void setup(){
 pinMode(BUTTON, INPUT);
 Serial.begin(9600); //シリアル通信はデバッグ用
 Ethernet.begin(mac);
}

void loop(){
 val = digitalRead(BUTTON);
 if (val == HIGH && old_val != val && isClose) {
 if (client.connect(server, 80)) {
 Serial.println("connect");
 sendHttpRequest();
 }
 delay(10);
 }
 
 old_val = val;
 
 if (client.available()) {
 char c = client.read();
 Serial.print(c);
 }
 
 // if the server's disconnected, stop the client:
 if (!client.connected() && !isClose) {
 Serial.println();
 Serial.println("disconnecting.");
 client.stop();
 isClose = true;
 }
}

//Web Proxyにデータを送信
void sendHttpRequest() {
 isClose = false;
 client.println("GET /salesforce/arduino-proxy.php HTTP/1.1");
 client.println("Host: 192.168.1.2");
 client.println("Connection: close");
 client.println();
}

Google Apps ScriptからSalesforceのAPIを叩いてみる。【色々イジる編】

Sat, 21 Jun 2014 18:32:18 +0000

前回はGoogleAppsScriptを使ってSalesforceのaccess_token取得まで行いました。

今回は実際にレコード取得してセルに入れたり、データを更新したり

MetadataAPI使ってカスタムオブジェクト作っちゃったりと色々とやってみます！

1. レコード取得してデータを格納

コードはこんな感じ。

/**
 * クエリ発行してスプレッドシートに書き込み
 */
function query(q) {
 checkAuthorization();
 
 //クエリ発行
 var prop = PropertiesService.getUserProperties();
 var sessionInfo = JSON.parse(prop.getProperty("session_info"));
 var res = UrlFetchApp.fetch(sessionInfo.instance_url + "/services/data/v30.0/query/?q=" + q, {
 "method" : "GET",
 "headers" : {
 "Authorization": "Bearer " + sessionInfo.access_token
 }
 });
 
 //レスポンスをパースして変数に格納
 var queryResult = JSON.parse(res.getContentText());
 var fieldsArray = getFieldsFromQueryResult(queryResult);
 var records = [fieldsArray];
 
 queryResult.records.forEach(function(record){
 var pushRecord = [];
 fieldsArray.forEach(function(field) {
 pushRecord.push(record[field]);
 });
 records.push(pushRecord);
 });

 //シートに書きこみ 
 var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
 var range = SpreadsheetApp.getActiveRange();
 sheet.getRange(range.getRow(), range.getColumn(), records.length, fieldsArray.length).setValues(records);
 
}

/**
 * QueryResultから項目リストを取得
 */
function getFieldsFromQueryResult(qr) {
 var fields = Object.keys(qr.records[0]);
 fields.forEach(function(field, i){
 if (field == "attributes") {
 return fields.splice(i,1);
 }
 });
 return fields;
}

/**
 * 認証状態を確認し、access_tokenの有効期限が切れていたら
 * refresh_tokenでaccess_tokenを再取得する。
 */
function checkAuthorization() {
 var prop = PropertiesService.getUserProperties();
 var sessionInfo = JSON.parse(prop.getProperty("session_info"));
 var res = UrlFetchApp.fetch(sessionInfo.instance_url + "/services/data/v30.0", {
 "method" : "GET",
 "headers" : {
 "Authorization": "Bearer " + sessionInfo.access_token
 },
 "muteHttpExceptions": true
 });
 
 if (res.getResponseCode() === 401) {
 var res = UrlFetchApp.fetch(
 ACCESS_TOKEN_URL, 
 {
 "method" : "POST",
 "payload" : {
 "grant_type": "refresh_token",
 "client_id": CLIENT_ID,
 "client_secret": CLIENT_SECRET,
 "refresh_token": sessionInfo.refresh_token
 },
 "muteHttpExceptions": true
 });
 
 if (res.getResponseCode() == 200) {
 var newSessionInfo = JSON.parse(res.getContentText());
 newSessionInfo.refresh_token = sessionInfo.refresh_token;
 prop.setProperty("session_info", res.getContentText());
 }
 }
}

UserPropertyの"session_info"にはaccess_token等を格納しています。

Google Apps ScriptからSalesforceのAPIを叩く【access_token取得まで】

Fri, 13 Jun 2014 00:19:36 +0000

前回はVBAでSalesforceの環境を弄りましたが、VBAだとローカル環境なスクリプト言語なので、操作性やパフォーマンスの良さ等のネイティブな良さを活かせる一方で、ネットに繋がっている環境でいつでも、どこでも、どんな端末でも動かしたいという要件は満たせません。

そんなときにはGoggle Apps Scriptが便利です。Google Apps ScriptはGoogleのサービスを拡張できたり、Webサービス作れたりするPaaSなスクリプト言語になります。

VBAからSalesforceのAPI叩いてみる。

Sat, 24 May 2014 18:54:40 +0000

Salesforceの導入支援とかしてると、VBAを使ってSalesforceのAPIを叩きたくなることは多々あります。

Excelでちょっとデータ加工してExcelから直でデータインポートしたいんだよなー、とか
Excelで作ったオブジェクト定義書からSalesforceにオブジェクト作りたいんだよなー、とか
ちょっとデータ見たいんだけど、データローダ使ってCSVインポートして…てやってられるか！とか
プロトタイプでガーってオブジェクト作ったけどオブジェクト定義書作ってない！Salesforceから一気に定義書作れたら良いのに！とか

fiddler使ってSOAPとお友達になる。

Wed, 21 May 2014 23:46:00 +0000

時代はRESTですがSalesforceはSOAPでメタデータとか弄ったりするんで、

作成したいモノによってはSOAPとお友達にならないといけません。

がしかし

「SOAPってHTTPでXMLやりとりして、仕様拡張出来たりするやつっしょ？」

「C#でWebサービス参照して追加すると勝手にクラスとか追加されて簡単に使えるやつだよね？」

程度の理解であるSOAPレベル1のスライムな私としてはお友達になるまでちょっと時間がかかりそうなので

fiddlerというHTTP通信を監視できる~~ストーキング~~スーパープログラムを使って

SOAPメッセージを見てみることにしましたとさ。

今回はSalesforceのMetadataAPIのSOAPメッセージを見てみました。

1. fiddlerのインストール

ここからダウンロードして、インストール。

2. C#とか使って提供されているWSDLからスタブクラスを作成

C#の場合は以下のようにしてWebサービス参照を追加してスタブクラスを作成します。

2-1. ソリューションエクスプローラーの参照設定を右クリックして[サービス参照の追加]をクリック

2-2. 詳細設定をクリック

2-3. [Web参照の追加]をクリック

2-4. URLにWSDLファイルが置いてある場所を指定してWeb参照名を入力後、[参照の追加]をクリック

これでWSDLからのスタブ作成は完了。

実際にC#で使う場合はこんな感じ(partner.wsdlもインポート済み)

class Program {
 //カスタムオブジェクトをCRUDで作成するサンプル
 static void Main(string[] args) {
 Partner.SforceService service = new Partner.SforceService();
 Partner.LoginResult lr = service.login("input your name", "input your password");
 service.Url = lr.serverUrl;
 service.SessionHeaderValue = new Partner.SessionHeader();
 service.SessionHeaderValue.sessionId = lr.sessionId;

 Metadata.MetadataService meta_service = new Metadata.MetadataService();
 
 meta_service.Url = lr.metadataServerUrl;
 meta_service.SessionHeaderValue = new Metadata.SessionHeader();
 meta_service.SessionHeaderValue.sessionId = lr.sessionId;

 CustomObject co = new CustomObject();
 co.deploymentStatus = Metadata.DeploymentStatus.Deployed;
 co.deploymentStatusSpecified = true;
 co.description = "このオブジェクトはC#から作ってます";
 co.fullName = "CSH__c";
 co.label = "DotNet Custom Object";
 co.pluralLabel = "DotNet Custom Objects";
 co.sharingModel = Metadata.SharingModel.ReadWrite;
 co.sharingModelSpecified = true;
 co.nameField = new Metadata.CustomField();
 co.nameField.type = Metadata.FieldType.Text;
 co.nameField.label = "The Name";
 co.nameField.length = 100;
 co.nameField.lengthSpecified = true;

 meta_service.create(new Metadata.Metadata[] { co });
 }
}

elasticsearchに閲覧履歴を入力するchrome extension作ってみた。

Sun, 11 May 2014 20:35:56 +0000

記事にしたのは良いものののelasticsearch+kibanaの使い方がイマイチわかんないですが

今回はWebの閲覧履歴をelasticsearchに送るようなchrome extensionを作ってみました！

これで、自分のWeb閲覧履歴を分析できるぜ！（目的は謎）

chrome extensionは一年前にドットインストールで勉強したくらいのスーパー初心者っす。

ということで、開発物をgithubにアップしてみました。

extensionのリファレンスはこちらから

以下はchrome extensionの備忘録。

1. chrome extensionのファイル構成

●　manifest.json　→　chrome extensionのメタデータファイル

●　jquery.min.js　→　みんな大好きjQuery。DOMとかajaxで使ってます。

●　background.html →　chrome extensionをインストールするとbackground pageが裏で動くという

構成になっていて、主にイベントハンドラとして利用するらしい。

●　background.js　→　background.htmlで利用するjsファイル。

本当はhtmlファイルにベタ書きしたかったんだけどscriptファイルは別ファイルにしないといけない決まりがあるらしいっす。

●　options.html　→　設定画面用のhtmlファイル

●　options.js　→　options.htmlで利用するjsファイル。

2. manifest.jsonについて

chrome extensionの名前とか説明とかbackgroundページのhtmlやoptionページのhtmlを指定するファイル。

extensionが扱うAPIのパーミッションもここで指定する。

XMLHttpRequestでCrossOriginに対して通信を行う場合は"https:///“とかの形式で権限を与える必要がある。

今回は以下のようなmanifest.jsonを作成。

{
 "name" : "chrome client for elasticsearch",
 "version" : "1.0",
 "manifest_version" : 2,

 "description" : "elasticesearchに履歴データを突っ込むんで自分のWeb閲覧履歴を解析するchrome extension",

 "background" : {
 "page" : "background.html"
 },

 "options_page" : "options.html",

 "permissions" : [
 "*://*/*", 
 "history",
 "webRequest",
 "storage",
 "notifications"
 ]
}

Web閲覧履歴はhistory、XMLHttpRequestはwebRequest、localstorageはstorage

elasticsearch+kibanaでSFDCのアクセスログ取ってみる。

Thu, 08 May 2014 22:39:22 +0000

fluentd+elasticsearch+kibanaの構成でログ解析をすることが流行っているらしい！

ということで、今回はSFDCの画面からアクセスログを取ってelasticsearch+kibanaで

ビジュアライゼーション＆解析するっていうことをやってみました。

（個人的に一般ユーザのアクセスログだけじゃなく、管理する側のアクセスログとか取って解析して

何か面白いもの見れないかなーなんて思ってます。）

流れとしては

SFDCからelasticsearchにデータを登録する

→elasticsearchのデータをkibanaで見る

って感じ。

elasticsearchとkibanaのインストール・セットアップ方法に関しては以下を参照ください！

fluentd + Elasticsearch + Kibanaで始めるログ解析 (セットアップ編)

0. SFDCからデータ登録をする際の方針

SFDCのお知らせ等のサイドバーコンポーネントにデータ登録用のスクリプトか何かを

埋め込むという方式で行いますが、方法としては

a. お知らせにJavaScriptを埋め込んでajaxでelasticsearchにデータを飛ばす

b. お知らせに埋め込んだJavaScriptでVFを呼び出すscriptタグあるいはiframeタグを動的に生成して、

そのVFページ(Apex)からelasticsearchに対してコールアウトする。

の2パターンがありそうですが、aはCORSの対応が必要が面倒そう（っていうかハマった…orz）なので

今回はbのApexからコールアウトする方式で！

1. Visualforceページ + Apexクラスの作成

こんな感じで

#LoggerES.cls
public with sharing class LoggerES {
 public LoggerES() {
 Map<String, String> params = ApexPages.currentPage().getParameters();
 String jsonBody = JSON.serialize(new Map<String, String>{
 'user' => UserInfo.getUserId(),
 'url' => params.get('url'),
 'ref' => params.get('ref')
 });
 
 HttpRequest req = new HttpRequest();
 req.setHeader('Content-Type', 'application/json; charset=UTF-8');
 req.setHeader('Content-Length', String.valueOf(jsonBody.length()));
 req.setEndpoint('http://{domain}:9200/sfdc/access_log');
 req.setMethod('POST');
 req.setBody(jsonBody);
 
 Http http = new Http();
 HTTPResponse res = http.send(req);
 System.debug(res.getBody());
 }
}

Bitbucket + JenkinsでSalesforceのCI

Tue, 29 Apr 2014 20:16:30 +0000

前回はJenkinsで手動デプロイをするところまでやったので、今回はbitbucketと連携させてみます。

仕組みとしては

bitbucketにコミット

→コミットをトリガとしてhook(HTTP POST)が起動し、jenkinsに通知する。

→jenkinsは通知されたタイミングでbitbucketからデータを取得して、取得したデータでantを走らせる。

って感じです。

1. Jenkinsにgitのプラグインをインストール

Jenkinsの管理＞プラグインの管理　からGIT pluginをインストール。

2. jenkinsユーザのssh設定

まずjenkinsユーザでsshキーを作成します。

$ su - jenkins
$ ssh-keygen

生成された公開鍵(${JENKINS_HOME}/.ssh/id_rsa.pub)をbitbucketに設定します。

初回はknown_hostsにbitbucketが登録されていないので

$ git ls-remote -h git@bitbucket.org:{bitbucket_user}/{bitbucket-repository}.git

とかで登録しておきます。

3. 新しいJobを作成

ソースコード管理にbitbucketのリポジトリを設定

ビルド・トリガはSCMポーリング。スケジュールは空白で。

bitbucketにID/Passwordを保持したくなかったので

適当なディレクトリにbuild.xmlとbuild.propertiesを入れる。

あとは同じ

4. antの設定ファイルを編集

今回はbuild.xmlやbuild.propertiesが別の場所にあるので相対パスは使ってません。

# /home/jenkins/build_properties/build.xml
<project name="Sample usage of Salesforce-CI Ant tasks" default="deployForCI" basedir="." xmlns:sfc="antlib:com.yutagithub.sforce.ci">
 <property file="build.properties" />
 <property environment="env" />

 <!-- Build / TestResult never actually saves to the server -->
 <target name="deployForCI">
 <sfc:deployForCI username="${sf.username}" password="${sf.password}" serverurl="${sf.serverurl}" deployRoot="/var/lib/jenkins/workspace/${sf.workspace}/src" sobjectPlural="true" checkOnly="true" testResultFile="/var/lib/jenkins/workspace/${sf.workspace}/test-result.xml" coverageResultFile="/var/lib/jenkins/workspace/${sf.workspace}/coverage.xml"/>
 </target>
</project>

Jenkinsを使ってSalesforceのCIにトライ

Tue, 29 Apr 2014 14:57:23 +0000

今更感がありますが、JenkinsでSalesforceのCIにチャレンジ！

今回は手動デプロイ実行と、カバレッジ/テスト結果表示まで。

1. JenkinsやWebサーバ、antのインストール

まずはここから。

$ apt-get update
$ apt-get install jenkins nginx ant

2. nginxの設定変更

/etc/nginx/sites-enabled/default　を以下のように編集して

Basic認証とJenkinsへのリバースプロキシを設定します。

server {
 listen 80 default_server;
 listen [::]:80 default_server ipv6only=on;

 root /usr/share/nginx/html;
 index index.html index.htm;

 server_name *****;

 location / {
 auth_basic_user_file /etc/nginx/.htpasswd;
 auth_basic "jenkins server";
 proxy_pass http://localhost:8080;
 proxy_set_header Authorization "";
 }
}

※ここでは非SSLの設定ですが、Basic認証使っているので絶対にSSLにした方が良いです。

→参考URL：JenkinsサーバのSSL対応とBasic認証

htpasswdの設定も忘れずに

$ apt-get install apache2-utils
$ htpasswd -c /etc/nginx/.htpasswd jenkinsuser

DockerのPrivateなリポジトリをs3に作る

Sat, 26 Apr 2014 18:50:41 +0000

Dockerは https://index.docker.io/にPublicなリポジトリを持てるんだけど

docker-registryっていうのをdockerイメージを使えば

Privateなリポジトリを超簡単に持てる＆S3に永続保持できるらしいので試してみた。

Publicなところに、AWSのClientIDとかSecretKeyとかうっかり保存しそうな私みたいな人には超オススメ。

やりかたは超簡単でregistry立ててpushするだけ！

1. docker-registryをpullしてコンテナー化

$ docker pull registry
$ docker run -i -t registry /bin/bash

registryもdockerで提供されているっていう。

2. registryのconfigファイル設定

$ cd /docker-registry/config
$ mv config.yml config.yml.original
$ cp config_s3.yml config.yml
$ vim config.yml

config.ymlはこんな感じで。(S3の例)

prod:
 storage: s3
 boto_bucket: test-docker
 s3_access_key: AKI*************
 s3_secret_key: ****************************
 s3_bucket: test-docker
 s3_encrypt: true
 s3_secure: true
 secret_key: xxxxx
 storage_path: /images

サンプルは何故かs3_encryptとs3_secureが2つずつあったので

1つずつ削除しました。（ちゃんと動いているので多分OKだと思います。）

storage_pathは実際にS3に格納される時のサブディレクトリを指定します。

force.com Sitesにリバースプロキシを挟んで独自ドメインSSL対応させてみる。

Mon, 21 Apr 2014 00:13:17 +0000

force.com Sitesでは非SSLにおいて独自ドメインを設定できますが、SSLにおいては独自ドメインを適用できません。

force.com Sitesはポータル系のログイン画面やフォーム画面等で利用されることが多く

企業によっては「ドメインにforce.comとか入ってるのはダメ！」とか言われちゃったりします。

これ、リバースプロキシで出来るんじゃね？ということでちょっとやってみることに。

方法は簡単で、適当なWebサーバを用意してリバースプロキシの設定をするだけ。

以下はnginxの設定例

server {
 listen 443;
 server_name *******.com; #独自ドメイン

 ssl on;
 ssl_certificate server.crt;
 ssl_certificate_key server.key;

 ssl_session_timeout 5m;

 ssl_protocols SSLv3 TLSv1;
 ssl_ciphers ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv3:+EXP;
 ssl_prefer_server_ciphers on;

 location / {
 proxy_pass https://****-developer-edition.na7.force.com/; #SitesのベースURL
 }
}

あとは設定したドメインにアクセスするだけ！

今回試したVFページ＋Apexはこんな感じ

<apex:page controller="SitesTestPage" showHeader="true">
 <script type="text/javascript">
 var send = function() {
 Visualforce.remoting.Manager.invokeAction(
 '{!$RemoteAction.SitesTestPage.sendRA}', 
 function(result, event){
 console.log(result);
 }, 
 {escape: true}
 );
 };
 </script>
 <apex:outputText value="{!display}" id="display"/>
 <apex:form >
 <apex:commandButton value="送信！" action="{!send}"/><br/>
 <apex:commandButton value="送信！(ajax)" action="{!send}" reRender="display"/><br/>
 username:<apex:inputText value="{!username}"/><br/>
 password:<apex:inputSecret value="{!password}"/><br/>
 <apex:commandButton value="login" action="{!login}"/>
 </apex:form>
</apex:page>

GoInstant触ってみる【ACL編】

Sun, 20 Apr 2014 23:00:54 +0000

これまで、GoInstantのデータの取り扱いについて説明してきましたが、実際のアプリケーションでは

”このルームにはこのユーザしか入れない”とか

”この時間になったら、このルームへの入出を許そう”とか

”このデータを取得できるのはadminユーザだけ”とか

そういったアクセスコントロール要件が出てきます。

もちろんこういったアクセスコントロールにもGoInstantは対応しています。

ということで、今回はACLについて。

基本的にGoInstantではAccess ControlというJSONの設定とユーザのJWT（ユーザ名とかグループ名）によって

制御することができます。

例えば、RoomにJoinできるユーザを絞り込みたいときは

{
 "$room": {
 "#join": { "users": ["localhost:tzm%40freedom-man.com"] },
　...
}

こんな感じにやると、localhostで発行されたtzm@freedom-man.comっていうユーザがJoinできる設定になります。

（@を%40にしないとエラーになったので、ちゃんとURLエンコードしないとダメみたい…。）

グループだとこんな感じ。

{
 "$room": {
 "#join": {"groups": ["freedom-man"]},
 ...
}

freedom-manっていうグループに属するユーザはJoinできるっていう設定になります。

一つ一つ特定のユーザ名やグループ名を設定するのは正直しんどいので、

ルームの名前が付いたグループとかユーザ名を一括で許可する設定ができます。

{
 "$room": {
 "#join": {
 "groups": [
 "$room-grp"
 ]
 },
 ...
}

こうすると、ルームの名前 + “-grp"の名前（lobbyだったら"lobby-grp”）のグループに対して

一括でJoinの権限を付与することができます。

あるキーの読み取りを制限したい場合は以下のように書きます。

{
 "$room": {
 ...
 "test": {
 "#get": {
 "users": [
 "localhost:tzm%40freedom-man.com"
 ]
 },
...
}

これで、localhostから発行されたtzm@freedom-man.comユーザのみtestキーの値を取得することが出来ます。

onメソッドのイベントも制御することができます。

{
 "$room": {
 ...
 "test": {
 "#onSet": {
 "users": [
 "localhost:tzm%40freedom-man.com"
 ]
 },
...
}

こうすると、on(“set”, … と記述してもlocalhost:tzm@freedom-man.comユーザ以外では

GoInstant触ってみる【CollectionとDataLifeCycle】

Fri, 18 Apr 2014 00:56:09 +0000

今回はGoInstantのCollectionとDataLifeCycleについて！

Collection

GoInstantはJSONのキーバリューを動的に増やしていくような機能(add)を持ってます。

サンプル↓

goinstant.connect(url).then(function(result){
 room = result.rooms[0];
 var key = room.key('/test'); 
 return key.add("added data!!");
}).then(function(result){
 console.log(result);
});

見ての通り、key値が自動的に生成されて、そのkeyに対して指定した値がセットされます。

addを繰り返すと、こんな感じに増えていきます。

‘/test/xxxx’っていう重複しないキーに対して値をセットすれば同様の挙動を得られますが、

自動的に重複しないキーを生成したい場合はaddを利用することになります。

※配列やオブジェクトの型を持つ値に対して

読み込み(get)→読み込んだデータに値を追加→書き込み(set)

というフローでもいけそうですが、トランザクションを考えると排他制御をかけないといけないし

排他制御をしたところで、リアルタイムなコミュニケーションはできなくなるので、この方法はダメ。

Data Life Cycle

GoInstantではデータの有効期限を設定することが出来ます。

以下のコードはセットしたデータが3秒後に削除されるサンプルです。

goinstant.connect(url).then(function(result){
 room = result.rooms[0];
 var key = room.key('/test');
 key.on("remove", function(value, context){
 console.log(value);
 console.log(context);
 });
 return key.set('test', {expire: 3000});
}).then(function(result){
 console.log(result);
});

ちなみにここで設定するexpireは、GoInstant上で保存されたタイミングから起算するため、

JavaScriptで設定してGoInstantサーバにデータが保存されるレイテンシを考えると

多少の誤差があります。（といっても秒レベル）

また、階層構造上、親子関係でない値であっても、キー同士を関連付けて

「ある特定のキーが削除されたら、関連するキーも削除する」といったことが可能です。

goinstant.connect(url).then(function(result){
 room = result.rooms[0];
 var key = room.key('/test/aaa');
 var parent = room.key('/test/cd');
 return key.set('test', { cascade : parent});
}).then(function(result){
 console.log(result);
});

//'test/aaa'の値も削除される。
room.key('/test/cd').remove();

GoInstant触ってみた【Retrieving&Setting Keys編】

Sat, 12 Apr 2014 01:25:43 +0000

今回はGoInstantで一番大事（だと思ってる）なデータ部分の操作を解説してみます。

任意のキーの値を設定

前回同様connectでroomにJoinしてroomのメソッドで

var key = room.key('/test');
key.set('aaa').then(function(result){
 console.log(result);
});

と書くと、/testのキーに対する値を設定できます。

返り値のresultはこんな感じ↓

オブジェクト、数値型、配列の値も入力できます。

var key = room.key('/test');
key.set({"aaa": "bbb", cd:[1,2,3]}).then(function(result){
 console.log(result);
});

任意のキーの値を取得

こんな感じで取得できます。

var key = room.key('/test');
key.get().then(function(result){
 console.log(result);
});

Roomのデータの持ち方は階層構造になっていてJSONみたいな構造になっています。

1Room1JSONって感じで、"/test"のキー値が{“aaa”: “bbb”}のようなオブジェクト構造であれば

“/test/aaa"というキー値で"bbb"という値を取ってこれます。

また、以下のように”/“というRootのキー値を指定するとRoom内の全てのデータを取得出来ます。

var key = room.key("/");
key.get().then(function(result){
 console.log(result);
});

キー値の設定を検知

var key = room.key("/test");
key.on("set", function(value, context) {
 console.log(context);
 console.log(value);
});

valueは更新値、contextは誰が何を更新したか的な情報になります。

キーの削除

var key = room.key("/test");
key.remove();

removeの検知はkey.on(“remove”, … でOK。

キー値を削除するので、下位のキー値も全て削除されます。

また、”/.users"は削除できないっぽいです。Joinしてるからそりゃ無理ですよね…。

これらのキー値の取得、設定、削除、変更の検知を駆使してWebRTCを実現するのが

GoInstantアプリケーションのメインの部分になると思います。

GoInstant触ってみた【User Presence&Data編】

Fri, 11 Apr 2014 01:30:59 +0000

WebRTCサービスのGoInstant触ってみたので基本的なところを紹介してみまっす。

GoInstantの紹介は以下のWebサイトが詳しいです。

・リアルタイムBaaS「GoInstant」の概要

超カンタンに言うと、GoInstantはチャットやWeb会議的なリアルタイムコミュニケーションアプリを

簡単に作るためのサービス（Baas）です。

GoInstantではRoomという概念があります。

これはデータ伝達範囲の単位で、GoInstantでは同一Room内でのみデータのやり取りが行われます。

GoInstantではRoomに対して各ユーザがJoin（ログイン的なもの）して、Room内のデータを操作したり

同一Roomの他のユーザがデータを更新したら、即座に画面に反映したりといったことが出来ます。

一人のユーザが複数のRoomにJoinすることもできます。

Room内のデータは階層構造で持っていて、JSONみたいな感じです。

JSONのプロパティに当たる部分をGoInstantではkeyと呼びます。

（むしろJSONでもkeyって呼ぶ気がするけど…）

概念的なことはさておき、~~これ以上説明するとボロが出る~~百聞は一見に如かずということで、

実際にコードを書いていきます！

GoInstantに接続(RoomにJoin)

以下のようなコードを書けばOK。

<!DOCTYPE html>
<html>
 <head>
 <meta charset="utf-8"/>
 <script src="https://cdn.goinstant.net/v1/platform.min.js"></script>
 <script>
 var url = "https://goinstant.net/xxxx/*****";
 goinstant.connect(url, function(err, connection, room){
 if (err) {
 console.log(err);
 }
 console.log(room);
 }); 
 </script>
 </head>
<body>
</body>
</html>

これを実行するとguestアカウント（匿名）としてデフォルトのRoomである[Lobby]にjoinします。

guestアカウントの表示名やJoinするRoomを指定するにはconnectメソッドの部分を

以下のように書き換えるだけ。

var userObj = {
 user: {
 displayName: "Test"
 },
 room: "TestRoom"
};
goinstant.connect(url, userObj, function(err, connection, room){
...
}

基本的にはこのconnectを実行した後の非同期コールバック関数の引数に入る

roomやconnectionを使って色々と操作をすることになります。

Room内にJoinしているユーザ一覧を取得する

connect実行後のコールバック関数のroomオブジェクトを使って

room.users.get().then(function(result){
 var users = result.value;
 var userIds = Object.keys(users);
 userIds.forEach(function(id){
 console.log(users[id].displayName);
 });
});

と書けばOK。

force.comのOAuth 2.0 JWT Bearer Token Flow試してみた。

Sun, 06 Apr 2014 17:41:19 +0000

force.comのOAuthをJWT投げ入れるだけで出来るらしい（ヘルプ）ので、試してみた。

JWT投げ入れるだけでOAuth2.0でアクセス許可を得られると言っても

対象ユーザが既に認可しているか、管理者が事前にユーザを承認していなければ利用できません。

つまり、refresh_tokenの代替手段になります。

JWTではコンシューマの秘密(client_secret)の代わりに

x509証明書をアプリに登録して、Webアプリ側で登録したx509に基づく秘密鍵を使って

JWTのSignature生成を行うことで、なりすまし等の不正アクセスを防ぎます。

ということで、実際に進めてみます。

1. x509証明書を作成

linuxとかでこんな感じに作成します。

$ openssl genrsa 2048 > server.key
$ openssl req -new -key server.key > server.csr
$ openssl x509 -days 3650 -req -signkey server.key < server.csr > server.crt

2. 接続アプリケーションの作成

サンプル↓

デジタル署名を使用にチェックを付けて、ファイルには1で作成した証明書(server.crt)をアップロード。

また、選択したOAuth範囲に"ユーザに代わっていつでも要求を実行"を必ず入れてください。

これを入れないと、認可しても以下のエラーが出てトークンが発行できなくなります。

{"error_description":"user hasn't approved this consumer","error":"invalid_grant"}

それ以外は、通常のOAuthアプリと同様に作成すればOKです。

3. Webアプリ側でJWTを生成する

JWTヘッダは{"alg":"RS256"}

JWTクレームセットは

“iss” → SFDCアプリケーションのClientID “prn” → SFDCのユーザ名 “aud” → https://login.salesforce.com or https://test.salesforce.com “exp” → 発行したJWTの有効期限タイムスタンプ(5分以内)

PythonとかApexでJWT作ってGoInstantにぶっこんでみる。

Sat, 05 Apr 2014 01:30:00 +0000

SalesforceがGoInstant買収してどうのこうのって話らしいので、GoInstant試してます。

GoInstantでユーザ認証するには外部の認証プロバイダ（facebook, salesforce, github, google, twitter）

を使ってOpenID Connectやら何やらで認証するか

自前の認証プロバイダ（と言っても普通のログイン機能を有するアプリ）で

JWTをGoInstantに投げ入れて認証します。

前者の場合はそれぞれのアプリケーション設定して

ClientIDとかSecretを設定してJS叩くだけで超簡単に実装できます（リファレンス）。

後者のJWT生成もGoInstantのライブラリ（Ruby、Java、PHP、node.js）があって

ライブラリのない言語の場合もJWT生成のライブラリを使えば、こちらも楽勝。

んで、PythonでチャレンジしようとJWT生成のライブラリをインストールしてみたけど

うまくいかなかったのでJWTの勉強がてら、自前で生成してみた。

import base64
import json
import hmac
import hashlib

def base64url_decode(input):
 input += '=' * (4 - (len(input) % 4))
 return base64.urlsafe_b64decode(input)

def base64url_encode(input):
 return base64.urlsafe_b64encode(input).replace('=', '')

key = base64url_decode("Input Your App Key")

header = {
 'typ':'JWT',
 'alg':'HS256'
}

payload = {
 'iss':'localhost',
 'sub':'test@freedom-man.com',
 'dn':'freedom-man@display',
 'g' :None
}

header_payload = base64url_encode(json.dumps(header)) + "." + base64url_encode(json.dumps(payload))

sig = base64url_encode(hmac.new(key, header_payload, seed, hashlib.sha256).digest())
print seed + "." + sig

force.comポータルでOAuth2.0

Mon, 31 Mar 2014 00:41:23 +0000

以前の記事でforce.comでREST APIを使用する際のドメイン名に関して取り上げたけど

ポータルへのOAuth認証(Sites利用)は

普通のSalesforceユーザへのOAuthの設定方法よりやや面倒な感じになる。

ということで、今回はポータル+Sites+OAuthについて書いてみる。

【ポータルOAuthの事前準備】

ポータルユーザに対してREST APIを利用したい場合は、対象ポータルに紐付けたSitesを設定する必要がある

※ポータルユーザに対してREST APIのOAuthリクエストをする際のドメインは、Sitesのドメインになる。

【ポータルOAuthの仕様・注意点】

SitesドメインのOAuthエンドポイントに対してAuthorizationCodeをリクエストするときに

ポータルユーザのセッションIDが切れていた場合は401のエラーページに遷移するので

当ページでログイン処理を行う必要がある。

401のエラーページではSite.Loginメソッドを使ってセッションを発行し

return値(PageReference)をクライアントに返す必要がある。

2のreturn値によってfrontdoor.jspにリダイレクトされることで

セッションIDがCookieにセットされ、OAuthのリダイレクトURLに遷移する。

※2-3の詳細はこの記事を参照。

401のエラーページっていうのはSitesの設定の以下の部分。

普通のSalesforceユーザに対するOAuth認証と異なるのは1-2の工程。

Sitesを使ってポータルユーザへのOAuthを行う場合には

401のエラーページのVF画面でSite.Loginメソッドを使って認証させる必要があります。

逆に、普通のSalesforceユーザではOAuthログイン画面の自由なカスタマイズが出来ないのに対して

ポータルユーザへのログインはフロントにSitesを利用しているため自由なカスタマイズが出来るということです。

また、注意しておかないといけない点としては

認証ページはVF画面（UnAuthorized）を使用できるので自由にカスタマイズできるが

認可の画面はカスタマイズできず、以下のような固定画面になること。

ポータル案件ではデザイン性が要求されるため

カスタマイズできない画面があるというのは、十分留意しておく必要があります。

コミュニティはここらへんどうなんだろう…？

Site.Loginの挙動とSalesforceの画面遷移

Sat, 29 Mar 2014 00:08:07 +0000

force.comでは、Sitesがポータルログインのフロントとしてよく使われます。

Salesforceが提供するカスタマーポータルの標準画面はアレだからね…。

で、Sitesを入り口にするということはVF、Apexでログイン処理をするわけで

ログインのメソッドとしてSite.Login(username, password, startUrl)というのがあって、

ここにバインドしたユーザ名やパスワードを入れたらSitesに紐付けたポータルにログインできます。

が、ここで注意しておきたいのが、Site.Loginメソッドが以下の手順でログイン処理を実装していること。

エンドユーザがユーザ名とパスワードを入力してログインボタンを押下する。（htmlのformタグによるPOST）
Apex側でSite.Loginを呼び出し、セッションを発行する。

※発行するだけで、エンドユーザのブラウザのCookieに保存するわけではないことに注意！

Site.Loginのreturn値であるPageReferenceをメソッドの戻り値としてreturnする。
エンドユーザはSite.Loginのreturn値のURL(https://[site-domain]/secur/frontdoor.jsp)にリダイレクトする。
frontdoor.jspにsidパラメータ付きで渡されると、sid値をセッションIDとしてレスポンスのSet-Cookieによって

ブラウザにCookieが設定されて、認証完了となる。

認証後の画面(Site.LoginのstartUrl値)にリダイレクトする。

実際のレスポンス（HTTPヘッダ）はこんな感じ(firebug)

Site.Loginのレスポンス↓

frontdoor.jspのレスポンス↓（ドメイン名やSessionIDや組織IDを隠そうとしたら、Cookieのほとんどが黒塗りｗ）

重要なのは、2の時点ではセッションを発行しているだけで、ブラウザにSet-Cookieを発行しているわけではなく、

frontdoor.jspに発行したセッションIDをパラメータで渡すことで

初めてブラウザにSet-Cookieが発行されるということ。

つまり、Site.Loginのreturn値を返さずに別のPageReference値を返すと

セッションが発行されるだけで、認証が完了しないということになります。

ただし、

PageReference loginPr = Site.login(username, password, startUrl);
String sessionId = loginPr.getParameters().get('sid');

のように、frontdoor.jspへのリダイレクトURLからセッションIDを取得して保持しておき

ログインするときにはfrontdoor.jsp?sid=[セッションID]のURLにリダイレクトさせてあげれば

Site.Loginを発行した直後ではない任意のタイミングでログインを実行させることも可能です。

また、上記でリダイレクトと書きましたが、これは301とかのステータスコードによるリダイレクトではなくて

JavaScript(location.href)によるオートリダイレクトになります。

つまり3でPOSTに対するレスポンスはlocation.href=[frontdoor.jspのurl]が書かれたhtmlで、

5のfrontdoor.jspに対するGETリクエストのレスポンスはlocation.href=[startUrl]が書かれたhtmlということ。

基本的にApexのPageReferenceでポストバックじゃない場合は、全部このリダイレクト方法っす。

ちなみに、Site.LoginでカスタマーポータルにログインしたときのドメインはSitesのドメインですが

デフォルトの/secur/login_portal.jspでログインしたり、login_portal.jspのformをハックする方法でログインすると

Salesforce組織のドメイン(csとかapとかnaとか)になります。

後者の方法でもPOSTすると、frontdoor.jspに飛ばされてCookieをセットするフローになります。

この後、/_nc_external/identity/legacylogin/server/PortalDoorっていうURLに飛ばされて

さらにリダイレクトしてstartUrlに遷移します。（legacyloginって思いっきり書いてあるｗ）

dockerコンテナで動くmysqlを永続化してみる【Zabbix編】

Sun, 16 Mar 2014 22:57:39 +0000

今回はdockerコンテナで動くmysqlデータをホストOS上にセーブすることで、

commitしなくてもデータを維持する！ということをしてみます。

今まではコンテナ落とす度にちゃんとcommitしないと、次に起動するときにデータが無くなり

Immutable Infrastructureとは程遠い感じになっていたので

サーバーは機能だけを提供して、データは別にするという疎結合な感じにするっていうのがモチベーション。

本日の参考サイトはこちら↓

http://www.zabbix.jp/documents/installation/install-rpm

http://cpw.hatenadiary.jp/entry/2013/08/20/220306

考え方としては、ホストOSにmysqlデータを格納してそれをコンテナがマウントして使うって感じ。

docker+zabbixの回で既にmysql-serverがインストールされているので、そのデータ移行もやってみます。

1. ホストOSに任意のディレクトリを作成。

コンテナにマウントさせる共有ディレクトリを作成します。

$ mkdir /home/tzm/docker/share
$ mkdir /home/tzm/docker/mysql

前者はダンプファイル共有用、後者はmysqlデータ格納用になります。

2. docker run でコンテナ作成。

1で作成した共有ディレクトリの内、ダンプファイル共有用のディレクトリをマウントしてコンテナを作成します。

$ docker run -v /home/tzm/docker/share:/share -i -t tzm/zabbix /bin/bash

これでホストOSの/home/tzm/docker/shareディレクトリがコンテナの/shareでアクセス出来るようになります。

3. mysqlのダンプを取ってマウントしたディレクトリ内に格納してコンテナを落とす。

$ cd /share
$ mysqldump -u root -p zabbix > dump.sql
$ exit

4. mysqlデータ共有ディレクトリをマウントして再度コンテナ起動。

$ docker run -v /home/tzm/docker/mysql:/var/lib/mysql \
-v /home/tzm/docker/share:/share -p 443:443 -p 10051:10051 -i -t tzm/zabbix /bin/bash

zabbixをnginxで動かす！

Sun, 16 Mar 2014 16:26:49 +0000

DigitalOceanの512MBプランでやっている都合上メモリは極力抑えたい。

apacheだとメモリ食いまくるので~~貧乏人~~節約家的にはシングルスレッドなWebサーバで

メモリは安くやりたいところです。

ということで前回インストールしたzabbixをnginxで動かします。

で、方法は色々とありそうですが、こちらの方法が簡単そうだったのでトライしてみました。

原理は簡単で、zabbixのパスでアクセスしてきたら

/usr/share/zabbix(phpアプリの場所)にアクセスするようにリンクを貼ってあげて

phpに対するアクセスはphp-fpmに渡せばOK。

ついでにSSLも対応しちゃいます。

まずはnginxとphp-fpmのインストールから

$ apt-get install nginx php5-fpm

ドキュメントルート直下にリンクを貼る

$ ln -s /usr/share/zabbix /usr/share/nginx/www/zabbix

SSLの証明書＆キーを作成

$ cd /etc/nginx
$ openssl req -new -days 365 -x509 -nodes -keyout cert.key -out cert.crt

ログ用のディレクトリを作成

$ mkdir /var/log/nginx/zabbix

/etc/nginx/conf.d/zabbix.confを作成

server {
 listen 80;
 listen 443 default_server ssl;

 root /usr/share/nginx/www;
 ssl on;
 ssl_certificate /etc/nginx/cert.crt;
 ssl_certificate_key /etc/nginx/cert.key;

 ssl_session_timeout 5m;

 ssl_protocols SSLv2 SSLv3 TLSv1;
 ssl_ciphers HIGH:!aNULL:!MD5;
 ssl_prefer_server_ciphers on;

 server_name ************;
 index index.html;
 access_log /var/log/nginx/zabbix/access_log main;
 error_log /var/log/nginx/zabbix/error_log error;

 location /zabbix {
 index index.php;
 }

 location ~ \.php$ {
 fastcgi_pass 127.0.0.1:9000;
 fastcgi_index index.php;
 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
 include fastcgi_params;
 }
}

DigitalOcean + docker + Zabbixで監視サーバ立ててみる

Sat, 15 Mar 2014 23:44:01 +0000

激安VPSのDigitalOceanで、dockerのコンテナでZabbixを使って

~~ストーキング~~監視サーバを立てるのが今回の目的。

何でZabbixかっていうと、先日のOSC 2014でトピックに上がっていて

個人的に興味持ったので、その検証用って感じっす。

何でDigitalOcean＆dockerかっていうと~~お金がないから~~今熱いからです！

で工程としては

DigitalOceanでサーバ立てる
dockerをインストール
dockerでコンテナを立てる
コンテナOSにZabbixとかインストール
Zabbixとapacheを起動
監視対象サーバにZabbixエージェントをインストールして起動
WebGUIで設定

って感じ。

1. DigitalOceanでサーバを立てる

DigitalOceanはAWSみたいにサーバを自由に作ったり壊したりできる

格安クラウドサービスで、月額500円でメモリ512MB相当のVPSを作れます。

今回はテキトーに512MBのUbuntuで作成。

EC2とかと違って、配布されるユーザはrootなので

作った後は作業用ユーザ作成して、sshのログインとかパスワード認証禁止して

公開鍵設定して、みたいなことは全部やんないとダメなので注意。

ここらへんは自前でChefとかで自動化した方が良いかもねー。

2. dockerのインストール

今回はUbuntu使ったので

http://docs.docker.io/en/latest/installation/ubuntulinux/

に従ってインストールする。

3. dockerでコンテナを立てる

dockerでコンテナを作成

$ sudo docker run -p 80:80 -p 443:443 -p 10051:10051 -i -t ubuntu /bin/bash

dockerの使い方はここらへんを参考にしました↓

http://apatheia.info/blog/2013/06/17/docker/

http://qiita.com/h_demon/items/096dafed2b8fec362323

最初のイメージをダウンロードする時間はちょっとかかるけど

一回ダウンロードした後のコンテナの起動は超早い、っていうか一瞬です。

4. コンテナOSにZabbixとかインストール

コンテナが作成されたらbash起動するので

Zabbixのインストール方法に従って、色々とインストール。

※上記リンクの順番と違って、Zabbixよりも先にmysql-serverをインストールするのがミソ。

$ apt-get install wget 
$ wget http://repo.zabbix.com/zabbix/2.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_2.0-1precise_all.deb
$ dpkg -i zabbix-release_2.0-1precise_all.deb
$ apt-get update
$ apt-get install mysql-server

JanrainとSalesforce連携してみる

Thu, 06 Mar 2014 00:12:03 +0000

前回説明したJanrain。

これ、SalesforceとSSOできちゃうみたいです。

ということで今回はSalesforceとソーシャルサインオン連携してみる回です。

認証プロバイダ作るあたりはgoogle, facebook, salesforceでSSOしたときと同じなので

こちらも合わせてご参考ください！

1. Janrainアプリのホワイトリストにsalesforceのドメインを追加

helpにはsalesforce.comを追加って書いてありますが

これじゃダメで、login.salesforce.com(あるいは*.salesforce.com)とSitesのドメインを指定してあげます。

ホワイトリストの設定が間違っているとこんな感じのエラーが出ます。

Sitesのドメインが設定されていない場合↓

何気にここが一番のハマりどころでした…。

2. 認証プロバイダの登録

セキュリティのコントロール＞認証プロバイダから新規に認証プロバイダを作成する。

プロバイダタイプをJanrainにして、コンシューマの秘密にJanrainのappKeyを設定。

で、こんな感じになる↓

他の認証プロバイダと違ってflowtype=xxxというパラメータが付与されています。

3. Sitesにログインページ(VF)を作成

こんな感じ↓

<apex:page showHeader="false" 
 standardStyleSheets="false"
 docType="html-5.0">
<html lang="ja">
<head>
<meta charset="utf-8"/>
<script type="text/javascript">
(function() {
 if (typeof window.janrain !== 'object') window.janrain = {};
 if (typeof window.janrain.settings !== 'object') window.janrain.settings = {};

 janrain.settings.tokenUrl = 'https://login.salesforce.com/services/authcallback/00Dxxxxxxxxxxxx/Janrain?flowtype={!$CurrentPage.parameters.type}';

 function isReady() { janrain.ready = true; };
 if (document.addEventListener) {
 document.addEventListener("DOMContentLoaded", isReady, false);
 } else {
 window.attachEvent('onload', isReady);
 }

 var e = document.createElement('script');
 e.type = 'text/javascript';
 e.id = 'janrainAuthWidget';

 if (document.location.protocol === 'https:') {
 e.src = 'https://rpxnow.com/js/lib/tzm-freedom/engage.js';
 } else {
 e.src = 'http://widget-cdn.rpxnow.com/js/lib/tzm-freedom/engage.js';
 }

 var s = document.getElementsByTagName('script')[0];
 s.parentNode.insertBefore(e, s);
})();
</script>
</head>
<body>
 <a class="janrainEngage" href="#">Sign-In</a>
</body>
</html>
</apex:page>

OpenID勉強してたら、Janrainというサービスを発見したので紹介してみる。

Wed, 05 Mar 2014 00:50:40 +0000

OpenID Connectローンチおめでとう！

ということで、OpenID ConnectはOAuth 2.0の技術を使ってるぐらいしか知らず、

OpenID 2.0もわりとさっぱりだったので最近勉強してたんですけど、よし使ってみるか！って思って

ライブラリ見てたら、JanrainというSaasを発見したので紹介してみるっていう流れ。

なお、Janrainに関する日本語の情報がとても乏しく、さらにJanrain経験3時間くらいのスライムなので

色々と間違っているかもしれませんが、いつも通りご容赦を。

で、Janrainは認証系のSaasで

・OpenIDとかOAuthとかそういう系のソーシャルサインオンを提供

・色んなWebアプリ（認証プロバイダ）に対応

・Janrain自体にもユーザ情報を確認できるらしい（未確認）

・シングルサインオンもできます

・ユーザ登録数とかログイン数とかの分析もできます

・Social Sharing（Twitterで共有的な）も簡単にできます

といったサービスです。

メインどころは一番最初に書いたソーシャルサインオンのところで、

普通はサービスに応じて認証プロトコルを変えないといけないから

OAuth 1.0, 2.0やらOpenID 1.1, 2.0, Connectやら色々と切り替えないといけなくて

利用言語のライブラリもその分対応してないといけないけど

JanrainだとAPI呼ぶだけであとはJanrainがサーバサイドでサービスごとの差異を吸収しますよー

っていうのが良いみたい。

百聞は一見に如かずということで、実際にやってみました。

1. Janrain登録

まずは登録。→https://dashboard.janrain.com/signin

もちろん、ソーシャルサインオンもできまっせ。

2. ダッシュボードからアプリ（Engage）を作成

ログインするとダッシュボード画面に遷移するので

[New Property]から新しいアプリ（Engage）を作成します。

3. 作成したアプリの吹き出しアイコン(?)をクリックして管理画面へ遷移

4. Sign-InsをクリックしてWidget作成画面に遷移

色々と表示されてますが、とりあえずSign-Insでソーシャルログイン用のWidgetを作成します。

ダッシュボード画面でユーザ登録数とかログイン回数をグラフで閲覧することもできます。

AnonymousなREST APIをCORSに対応させてみる。

Mon, 03 Mar 2014 00:03:47 +0000

以前、SitesでApex RESTクラスを公開することで認証なしで

Anonymous（サイトゲストユーザ）なREST APIをコールできます的な話をしましたが、

CORS対応できるかどうかを検証してみました！

CORSに関しては以下のURLが詳しい感じっす。

https://developer.mozilla.org/ja/docs/HTTP_access_control

http://dev.classmethod.jp/etc/about-cors/

で、今回検証したサンプル↓

@RestResource(urlMapping='/MyRestContextExample/*')
global with sharing class MyRestContextExample {	
 @HttpGet
 global static Account doGet() {
 RestRequest req = RestContext.request;
 RestResponse res = RestContext.response;
 res.addHeader('Access-Control-Allow-Origin', '*');
 String accountId = req.requestURI.substring(req.requestURI.lastIndexOf('/')+1);
 Account result = [SELECT Id, Name, Phone, Website FROM Account WHERE Id = :accountId];
 return result;
 }

 @HttpPost
 global static Boolean doPost() {
 RestRequest req = RestContext.request;
 RestResponse res = RestContext.response;

 res.addHeader('Access-Control-Allow-Origin', '*');
 return true;
 }
}

ApexからAutoScaling触ってみる。

Sun, 02 Mar 2014 10:37:15 +0000

今回はAuto ScalingをApexからREST APIで触ってみます。

Auto Scalingは指定したインスタンスが落ちたら自動的に指定のインスタンス数になるまで

同じインスタンスを立ててくれたり、指定した時刻にインスタンスを動的に増減させることのできる

自動でスケーリングをしてくれるサービスです。（って名前そのまんまの説明…）

これを使うと、

「毎週日曜日は負荷が高いから自動的に処理をするインスタンス数を増やそう！」とか

「万が一インスタンスが落ちてもすぐにインスタンスを立ち上げるようにしよう！」とか

「不健全なインスタンスを落として健全なインスタンスだけ生かしたい！」とか

こういったスケールアウト、スケールインが自由自在にできちゃいます。

前回はEC2をREST APIを使って手動で立ち上げていて、

”EC2のREST APIを使ってスケジュール化するためにはApexバッチが必要”と書きましたが、

このAuto Scalingを使えばスケールアウトを自動化できるので

インスタンス数を0→1にスケールアウトするようなスケジューリングをAuto ScalingをCUIとかで

一回設定してあげれば自動インスタンス起動の処理ができちゃいます。

Auto Scalingのスケジューリングに関する参考URL↓

http://dev.classmethod.jp/cloud/auto-scaling-schedule/

http://blog.suz-lab.com/2012/04/ec2.html

また、Auto Scalingを利用しない単純なEC2インスタンス起動は、立ち上げた後は負荷が高かろうが

インスタンスが落ちようが、別のAPIでチェックしない限りは検知することができないのと

検知しても自動的にスケールさせたり、落ちた時に自動的にインスタンスを立ち上げるという

仕組みを自前で実装しなければなりません。

そこで、Auto Scalingの出番ということです！

ということで、今回のサンプル！↓

public with sharing class AutoScalingCommon {
 /**
 * AccessKey
 */
 public String AWSAccessKeyId = EnvSetting__c.getOrgDefaults().AWSAccessKeyId__c;

 /**
 * SecretKey
 */
 public String AWSSecretKeyId = EnvSetting__c.getOrgDefaults().AWSAccessKeySecret__c;

 private final String REGION = 'us-east-1';

 private final String SERVICE = 'autoscaling';

 /**
 * AutoScalingGroupの更新(インスタンス数の最大、最小を変更)
 */
 public String updateAutoScalingGroup(
 String autoScalingGroupName,
 Integer minSize,
 Integer maxSize
 ) {
 List<String> signedHeaders = new List<String>{
 'host', 
 'x-amz-date',
 'content-length'
 };

 DateTime dt = DateTime.now();
 String credentialScope = dt.formatGmt('YYYYMMdd') + '/' + 
 REGION + '/' + SERVICE + '/aws4_request';

 Map<String, String> params = new Map<String, String>{
 'Action' => 'UpdateAutoScalingGroup',
 'Version' => '2011-01-01',
 'AutoScalingGroupName' => autoScalingGroupName,
 'MinSize' => String.valueOf(minSize),
 'MaxSize' => String.valueOf(maxSize)
 };
 String body = Utility.getParam(params);

 String stringToSign = this.createStringToSign(
 'AWS4-HMAC-SHA256',
 dt, 
 credentialScope, 
 this.createHashedCanonicalRequest(
 'SHA256',
 'POST',
 '/',
 new Map<String, String>{},
 new Map<String, String>{
 'Host' => 'autoscaling.' + region + '.amazonaws.com',
 'x-amz-date' => dt.formatGmt('YYYYMMdd') + 'T' + 
 dt.formatGmt('HHmmss') + 'Z',
 'content-length' => String.valueOf(body.length())
 },
 signedHeaders,
 body
 )
 );

 String signature = this.createSignature(
 'hmacSHA256',
 dt,
 region,
 SERVICE,
 Blob.valueOf(stringToSign)
 );

 return this.callAutoScalingCallCommon(
 dt,
 'autoscaling.' + REGION + '.amazonaws.com',
 credentialScope,
 signedHeaders,
 signature,
 body
 );
 }

 /**
 * AutoScalingへのAPIコールの共通メソッド
 */
 private String callAutoScalingCallCommon(
 DateTime dt,
 String hostname,
 String credentialScope,
 List<String> signedHeaders,
 String signature,
 String body
 ) {
 HttpRequest req = new HttpRequest();
 req.setHeader('Host', hostname);
 req.setHeader(
 'x-amz-date', 
 dt.formatGmt('YYYYMMdd') + 'T' + dt.formatGmt('HHmmss') + 'Z'
 );

 req.setHeader('Content-Length', String.valueOf(body.length()));

 req.setHeader(
 'Authorization',
 'AWS4-HMAC-SHA256 Credential=' + this.AWSAccessKeyId + '/' + credentialScope + ',' +
 'SignedHeaders=' + String.join(Utility.getLowerCaseSortedList(signedHeaders), ';') + ',' + 
 'Signature=' + signature
 );
 req.setEndpoint('https://' + hostname + '/');
 req.setMethod('POST');

 req.setBody(body);

 Http http = new Http();
 HTTPResponse res = http.send(req);
 return res.getBody();
 }

 /**
 * HashedCanonicalRequestを作成
 */
 private String createHashedCanonicalRequest(
 String algorithm,
 String method,
 String url,
 Map<String, String> params,
 Map<String, String> headers,
 List<String> signedHeaders,
 String payload
 ) { 
 String signature = '';
 signature += method + Constants.LF;
 signature += url + Constants.LF;
 signature += Utility.getSortedParam(params) + Constants.LF;
 signature += Utility.createCanonicalHeaders(headers) + Constants.LF;
 signature += String.join(Utility.getLowerCaseSortedList(signedHeaders), ';') + Constants.LF;
 signature += EncodingUtil.convertToHex(
 Crypto.generateDigest(
 algorithm,
 Blob.valueOf(payload)
 )
 );
 return EncodingUtil.convertToHex(
 Crypto.generateDigest(
 algorithm, 
 Blob.valueOf(signature)
 )
 ).toLowerCase();
 }

 /**
 * StringToSignを作成
 */
 private String createStringToSign(
 String algorithm,
 DateTime requestDateTime,
 String credentialScope,
 String hashedCanonicalRequest
 ) {
 String stringToSign = algorithm + Constants.LF;
 stringToSign += 
 requestDateTime.formatGmt('YYYYMMdd') + 'T' + 
 requestDateTime.formatGmt('HHmmss') + 'Z' + Constants.LF;
 stringToSign += credentialScope + Constants.LF;
 stringToSign += hashedCanonicalRequest;
 return stringToSign; 
 }

 private String createSignature(
 String algorithm,
 DateTime requestDateTime,
 String region,
 String service,
 Blob stringToSign
 ) {
 Blob kDate = Crypto.generateMac(
 algorithm,
 Blob.valueOf(requestDateTime.formatGmt('YYYYMMdd')),
 Blob.valueOf('AWS4' + this.AWSSecretKeyId)
 );
 Blob kRegion = Crypto.generateMac(
 algorithm,
 Blob.valueOf(region),
 kDate
 );
 Blob kService = Crypto.generateMac(
 algorithm,
 Blob.valueOf(service),
 kRegion
 );

 Blob kSigning = Crypto.generateMac(
 algorithm,
 Blob.valueOf('aws4_request'),
 kService
 );

 return EncodingUtil.convertToHex(
 Crypto.generateMac(
 algorithm,
 stringToSign,
 kSigning
 )
 );
 }
}

Auto ScalingはSignature Version2とVersion4の両方が使えるんですが、

ApexからEC2を触ってみる。

Sat, 01 Mar 2014 00:35:27 +0000

恒例の触ってみるシリーズ、今回はAWSの大黒柱（だと勝手に思っている）EC2です！

SalesforceでEC2を触ることのモチベーションの一つとしては

「Apexでは不可能な処理をEC2を一時的に立てて処理を行わせる」ということ。

例えば、Salesforceの全データをバックアップする！といったバッチ処理の場合は

force.com内部で行わせるよりは別サーバからデータローダCLI等のAPI経由でやってもらった方が

ガバナ制限から開放される上に、プログラミング言語がサポートする範囲の

自由な形式でデータを出力することができます。

しかし、常時稼働のサーバを立ててしまうとコストが大きいため

こういったデータバックアップのような処理はバッチ実行時のみのスポット稼働が求められます。

そこでEC2の出番ということです！

ということで今回のサンプル↓

/**
 * EC2コモンクラス
 */
public with sharing class EC2Common {
 /**
 * AccessKey
 */
 public String AWSAccessKeyId = EnvSetting__c.getOrgDefaults().AWSAccessKeyId__c;

 /**
 * SecretKey
 */
 public String AWSSecretKeyId = EnvSetting__c.getOrgDefaults().AWSAccessKeySecret__c;

 private final String REGION = 'us-east-1';

 /**
 * インスタンスのStart
 */
 public String startInstances(String instanceId) {
 Map<String, String> params = new Map<String, String>{
 'Action' => 'StartInstances',
 'AWSAccessKeyId' => this.AWSAccessKeyId,
 'SignatureMethod' => 'HmacSHA256',
 'SignatureVersion' => '2',
 'InstanceId.1' => instanceId,
 'Version' => '2013-10-15',
 'Timestamp' => DateTime.now().formatGmt('YYYY-MM-dd') + 'T' + DateTime.now().formatGmt('HH:mm:ssZ')
 };

 params.put('Signature', this.createSignature('POST', 'ec2.' + REGION + '.amazonaws.com', '/', params));

 HttpRequest req = new HttpRequest();
 req.setEndpoint('https://ec2.' + REGION + '.amazonaws.com');
 req.setMethod('POST');

 req.setBody(Utility.getSortedParam(params));
 Http http = new Http();
 HTTPResponse res = http.send(req);

 return res.getBody();
 }

 /**
 * インスタンスのStop
 */
 public String stopInstances(String instanceId) {
 Map<String, String> params = new Map<String, String>{
 'Action' => 'StopInstances',
 'AWSAccessKeyId' => this.AWSAccessKeyId,
 'SignatureMethod' => 'HmacSHA256',
 'SignatureVersion' => '2',
 'InstanceId.1' => instanceId,
 'Version' => '2013-10-15',
 'Timestamp' => DateTime.now().formatGmt('YYYY-MM-dd') + 'T' + DateTime.now().formatGmt('HH:mm:ssZ')
 };

 params.put('Signature', this.createSignature('POST', 'ec2.' + REGION + '.amazonaws.com', '/', params));

 HttpRequest req = new HttpRequest();
 req.setEndpoint('https://ec2.' + REGION + '.amazonaws.com');
 req.setMethod('POST');

 req.setBody(Utility.getSortedParam(params));
 Http http = new Http();
 HTTPResponse res = http.send(req);

 return res.getBody();
 }

 private String createSignature(
 String method,
 String hostname,
 String resource,
 Map<String, String> params
 ) {
 String signature = 
 method + Constants.LF +
 hostname.toLowerCase() + Constants.LF +
 resource + Constants.LF +
 Utility.getSortedParam(params);
 return String.valueOf(EncodingUtil.base64Encode(
 Crypto.generateMac(
 'hmacSHA256', 
 Blob.valueOf(signature),
 Blob.valueOf(this.AWSSecretKeyId)
 )
 ));
 }
}

Wordpressのパーマリンク変更

Thu, 27 Feb 2014 00:08:33 +0000

以前は/%category%/%post_id%/　という形式であったが、

他のWebサイトでも問題視しているように

・post_idは投稿時以外（下書き等）でもカウントアップされてしまい歯抜けになる。

・post_idはサーバー移行をすると移行前後で値が変わってしまうらしい。

・category変更があった場合にリンク切れを起こす

という大きな問題が有り、まだ投稿数60ちょっとしかない状況だったので

この際、/%post_name%/というユニークな投稿名を自分で決定する方式に変更した。

それに伴い、以前の/%category%/%post_id%/のパスで来た人を

/%post_name%/にリダイレクト(301)してあげる必要が出てきた。

色々と調べてきたら.htaccessを自分で書き上げる方法が良さそうだったので共有してみる。

参考URL↓

http://nekonomemo.net/wordpress-permalink-redirect/

http://webshufu.com/calc-and-get_posts-makes-redirecting-ease/

上記Webサイトに書かれているように、パーマリンク変更前と変更後をリスト出力して

Excelで

Redirect permanent /hoge_cateory/xxxx http://freedom-man.com/post_name

の形式で出力して.htaccessに記載するだけのシンプルな方法だが、

私の環境では何故か生成した.htaccessをドキュメントルート直下に置いても動作しなかった。

Redirectが効かないとか有り得ないので、

httpd.conf及びインクルードしているconfファイルの設定で上書きしているのでは？と思ったら、

案の定、httpd.confがインクルードしているconf/wordpress.confで

Alias /blog /var/www/hogehoge/

とエイリアスが貼ってあり、/blogはドキュメントルートじゃないところにアクセスしていたので、

リダイレクトディレクティブを/var/www/hogehoge直下の.htaccessに入れてあげたらちゃんと動作してくれた。

ということで、めでたしめでたし。

SalesforceとSWFの連携【机上の空論編】

Wed, 26 Feb 2014 23:58:08 +0000

さて、これまでApexからSWFと連携させてきましたが、

SalesforceとSWFの連携のユースケースについて自由気ままに考えてみます！

※今回はSWFについてあーだこーだ言う回です。特にまとまっていません。

SWFでシステムを実装したことないので机上の空論です。

ということで、ところどころ、おかしいところがあるかもしれませんが、ご容赦くださいm(_ _)m

1. Salesforce内部から外部Webサービスの利用

ApexからのHTTPコールアウトはガバナ制限があり、

1トランザクション当たりの長時間のコールアウトの対応が難しい。

※2014/02時点では1トランザクション当たりの合計時間が120秒以内の制限値。

そこで、長時間のコールアウトになる場合、つまり時間がかかるようなタスク処理をさせるには

HTTPリクエストに対する応答は即座に返し、タスク処理を非同期で実行するような仕組みが必要になる。

この非同期実行処理はSWFが適しており、

ApexからのHTTPリクエストはSWFに対してStartWorkflowExecutionを実行し、

処理を実行するDecider、Workerは処理を実行するサーバ側に立ててあげれば容易に実現できる。

非同期処理自体はSWF等のクラウドキューサービスがなくてもWorker上に実装できるが、

SWFを利用する方がスケールアウトしやすく再利用性が向上する。

ただし、タスク処理自体が同期実行でなければならない場合は、基本的にはSWFは適さない。

2. 外部WebサービスからSalesforceを利用する場合

外部WebサービスからSalesforceのデータを利用する場合は

a. Salesforceのデータを画面表示するような即時利用パターン

b. Salesforceのデータを別サーバDBに連携するパターン

c. 別サーバのデータをSalesforceに連携するパターン

の3パターンが考えられる。

a のような即時利用パターンではSWFのような非同期処理は向いていないので適用不可能。

この場合は素直にforce.com canvasとか使ってAPI使っでやるのが吉かと。

b では連携したいSalesforceレコードを、Salesforce側からSWFに投げてもらい

別サーバがWorkerとしてそのデータを受け取り、タスク処理（連携処理）を実行する方法が考えられる。

Salesforceではアウトバウンドメッセージという外部連携用の標準機能が存在するが、

疎結合のメリットを活かすのであれば、エンドポイントを共通化出来るSWFを利用した方法が良い気がする。

c では別サーバ側が作成・更新したいレコード情報をSWFに投げて、

そのデータをforce.comのApexスケジューラで拾わせてApexクラス側で作成・更新処理を行う。

単なるデータ同期だけでなく、Webフォームで入力されたデータをSWFを介して

Workerに処理させることができるので、連携先プラットフォームに変更があっても

送信元プログラムの変更がないことが利点。

Salesforceへの連携をする上でSWFを利用する共通のメリットとしては、APIコール数を消費しないということ。

デメリットとしてはSalesforceをWorkerやDeciderとして動作させるためにはApexスケジューラを利用する必要があり、

一日あたりのスケジュール実行数等の制限値・ガバナを考慮する必要があるということ。

また、cのパターンでWebフォームからの連携を考える場合、エラー時は同期実行、つまり即時でエラーを

エンドユーザに知らせる必要があるので非同期になるSWFでは適していない。

エラーハンドリングをWeb側で独自で行ってしまうと、

入力規則等のSalesforceのカスタマイザブルなビジネスロジックの構築というメリットを損ねてしまう上に

バリデーション系はモデルに実装すべきというMVCモデルの理想からも離れてしまう。

また、経験的にAPIコール数も上限を越えるケースがあまり無く、

上限もオプション（追加料金）である程度解決できたりするから

2のパターンにおけるメリットは全体的に微妙かな~とも思ったり。

結局のところ、疎結合・非同期処理と密結合・同期処理という2つの相反する特性を把握した上で

SWFを利用するか従来型のAPI連携をするかを判断をすべきかと。

密結合なシステムでも比較的小さなシステムであればそこまで大きな問題にはならない気がする。

一番大切なのはちゃんと動くシステム。その次に保守性。って感じ？

スケールアウトと再利用性は比較的大きいシステムでこそ大きな力を発揮できるものなのかな～思う。

あと、SWFの基本概念を学んだ印象としては、

「疎結合・非同期なシステムを作るにはとてもよいサービス」である一方で

AWSのSWFについて書いてみる【補足編】

Sat, 22 Feb 2014 22:59:12 +0000

前回まではApex(force.com)でSWFを触ってみましたが、今回はSWFに関する補足説明をしていきます！

【イベント登録に関する補足】

それぞれのActorがSWFに通知を行うことでワークフローが進むというのが

SWFのおおまかな構造になっていますが、通知を行う毎にワークフロー上には

イベントが登録されていきます。

イベント登録の流れについては正常系フローに沿って書くと以下のようになります。

1. ワークフローのスタート

StartWorkflowExecutionを実行すると、

WorkflowExecutionStarted、DecisionTaskScheduledの2つのイベントが登録されます。

2. Decision Taskの取得

PollForDecisionTaskを実行すると、スケジュールされたDecisionTaskがDeciderによって取得され

DecisionTaskStartedのイベントが登録されます。

3. Decision&ActivityTaskの登録

RespondDecisionTaskCompleted(ScheduleActivityTaskDecision)を実行すると、

DecisionTaskCompleted、ActivityTaskScheduledのイベントが登録されます。

4. Activity Taskの取得

PollActivityTaskを実行すると、Deciderによって登録されたActivityTaskが

Workerによって取得され、ActivityTaskStartedイベントが登録されます。

5. ActivityTaskの実行＆完了通知(DecisionTaskの登録)

RespondActicityTaskCompletedを実行すると、

ActivityTaskCompleted、DecisionTaskScheduledイベントが登録されます。

7. ワークフローの終了通知

CompleteWorkflowExecutionを実行すると、

DecisionTaskCompleted、WorkflowExecutionCompletedイベントが登録されます。

【各種タイムアウトに関する補足】

タイムアウトは以下の種類があり、WorkflowTypeやActivityType側で

それぞれ、デフォルト値を設定することができます。

a. ワークフロー本体の開始から終了までの時間(Execution Start to Close timeout)

ApexからSWFを触ってみる【ワークフローの終了まで】

Sat, 22 Feb 2014 13:37:29 +0000

前回はActivityTaskの登録までやったので、今回はワークフローの終了までやります！

※REST APIの基本的な部分は端折っているので、詳細な部分を知りたい方は過去記事をご参考ください！

4. Activity Taskの取得(PollForActivityTask)

実行ActorはWorkerになります。

Activity TaskListに投げられたActivity Taskを取得します。

public static String PollForActivityTask (
 String domain,
 String identity,
 Map<String, String> taskList
) {
 String jsonBody = JSON.serialize(new Map<String, Object>{
 'domain' => domain,
 'identity' => identity,
 'taskList' => taskList
 });
 return callSWFAPI('PollForActivityTask', jsonBody);
}

■主要パラメータの説明

identity

→どのWorkerが取得しようとしているかを明示する。ワークフロー履歴でTaskを取得したWorkerを特定するためのパラメータ。

taskList

→取得先のActivity TaskListを指定。3(ActivityTaskのスケジュール)と同じTask Listを設定すれば、

3で投げたワークフローのDecision Taskを取得可能。

レスポンスは以下のとおり

{
 "activityId": "20140222001",
 "activityType": {
 "name": "Step1",
 "version": "1.0"
 },
 "input": "Test Message",
 "startedEventId": 6,
 "taskToken": "AAAAKgAAAAEAAAAAAAAAAvVSh6dDFC0ONKeUJ5V4YZk0vaDKdDleJM44ZuQLyH3himdckWB6mlfE1/h50XB+3s7dRrfohwBLbK5j3e98AbLaUUYvDP6DVv9VTu3AWZK/Yj4groIH8+0dZ92BDv343v//czgLxB4UBv2U4OiDvZLynDv9QXguiSIH6dK6QYF+Dbb6JGHs9taGOkIsreAFYrc4ytRCYhMNJnHb6TQpquPWKMNDHaltFbshHGamQACmF67eBGeonfkD1sk7ERZko00SUbeCY75fI5CFkKTCjS9Q7hRHukWapFVG9+dEKKJ1",
 "workflowExecution": {
 "runId": "12ZEh2TCxHYJmPaQoN8noi6wgOhyZ0XIhFxxeOdgdpiWI=",
 "workflowId": "20140222001"
 }
}

ApexからSWFを触ってみる【ActivityTaskのスケジュールまで】

Thu, 20 Feb 2014 23:34:07 +0000

前回はREST APIのSignature生成とAPIコールの基本的なところを説明したので、今回は実際にSWFをApexから触ってみます！

ApexからSWFを触ってみる【REST API説明編】

Tue, 18 Feb 2014 01:44:06 +0000

前回、SWFの概要を説明しましたが、きっと私の説明力不足により

よくわからなかったと思うので、今回からは実際にApexからSWFを触ってみて挙動を確認します。

ApexでSWFを動かすには例のごとくSDKは存在しないので、

直接REST APIをコールする必要があります。

ということで、今日はREST APIをApexからコールするところのベース（Signature生成）を説明します！

さて、AWS REST API恒例のSignature生成ですが、

SimpleDBのSignature Version2やDynamoDBのSignature Version4と異なり、

Signature Version3という署名認証方式で行われます。

Signature Version3は以下の形式で生成します。

Canonicalヘッダ =
 "ヘッダ1:値1\n" +
 "ヘッダ2:値2" + ...;

string_to_sign = 
 "HTTPメソッド名\n" +
 "リソースのパス\n" +
 "クエリパラメータ\n" +
 "Canonicalヘッダ\n" +
 "HTTPリクエストのBody";

signature = hmac(digest(string_to_sign));

Apexのサンプルは以下のとおり

//Signatureの生成
private static String createSignature(Map<String, String> header_map, String postBody) {
 String string_to_sign = '';
 string_to_sign += 'POST' + Constants.LF;
 string_to_sign += '/' + Constants.LF;
 string_to_sign += '' + Constants.LF;
 string_to_sign += createCanonicalHeaders(header_map) + Constants.LF;
 string_to_sign += postBody;
 System.debug(string_to_sign);
 Blob b_sig = Crypto.generateMac(
 'hmacSHA256', 
 Crypto.generateDigest(
 'SHA256',
 Blob.valueOf(string_to_sign)
 ), 
 Blob.valueOf(AWSAccessKeySecret)
 );
 return EncodingUtil.base64Encode(b_sig); 
}

//Canonicalヘッダの生成
private static String createCanonicalHeaders(Map<String, String> headers) {
 if (headers == null || headers.keySet().isEmpty()) {
 return '';
 }

 Map<String, String> lowerCaseHeaders = new Map<String, String>();
 for (String key : headers.keySet()) {
 lowerCaseHeaders.put(key.toLowerCase(), headers.get(key));
 }
 String param = '';
 List<String> sortedKey = getSortedList(lowerCaseHeaders.keySet());
 for(String key: sortedKey){
 param += key + ':' + lowerCaseHeaders.get(key).trim() + '\n';
 }
 return param;
}

AWSのSWFについて書いてみる【概要と用語編】

Sun, 16 Feb 2014 22:55:21 +0000

最近、疎結合なシステム構築のためのサービスであるAWSのSQS、SWFに興味を持ったので触ってみた。

SQSは何でも色々できるけど、プログラムで制御しないと正常に動作しない部分が多くて、

SWFは疎結合なシステムをSQSより簡単に(?)構築できるらしい。（参考URLはこちら）

ということで、今回はSWFのお話。

といっても、私自身SWFを利用してのシステム構築は残念ながらまだない上に

SWFのお勉強3日目くらいのドシロートで、これから書く記事は机上の空論だったり、

そもそも誤った解釈があるかもしれませんが、そこらへんはご容赦を。

というかご指摘いただくと泣いて喜びます。

最後にSWFの用語をずらずらーっと並べて書いたのでそちらもご覧くださいませ。

で、SWFの話ですが、以下のリンク先のように既に色々と解説されているので、

まずはそちらをご覧頂いたほうが理解が早いかもｗ

http://dev.classmethod.jp/cloud/aws/introduction-to-amazon-simple-workflow-service/ http://www.slideshare.net/AmazonWebServicesJapan/20130424-aws-meisterregenerateswfpublic

簡単に言うとSWFはワークフローの各タスクを疎結合にするための仕組みを提供するサービス。

SWFではTaskList（キュー）に各々のタスクをスケジュールし、

タスク処理をするアプリ(Activity Worker)やビジネスロジックを制御するアプリ(Decider)が

それぞれのTaskListにポーリングを行い、各々のタスクを取得後、処理結果を登録し、

次のタスクをスケジューリングするという流れでワークフローの処理を進めていく仕組みになっている。

具体的には

Starterがワークフローをスタート＆Decision Task(Decider用のタスク)のスケジュール
DeciderがTaskListにポーリングしてタスクを取得
2のDeciderが過去のタスクの実行履歴を参照して、Activity Task(Activity Worker用のタスク)をスケジュール
Activity WorkerがTaskListにポーリングしてタスクを取得
4のActivity Workerがタスク情報を参照して、タスクを実行し、Decision Taskをスケジュール
2～5を繰り返して、ワークフローを進める
Deciderがワークフロー終了条件を満たしたと判断した場合、ワークフローを終了する

というようなフローになる。

SWFが提供しているTaskListを介することで、各々のWorker（アプリ）が

SWFと密結合になるものの、Worker同士は疎結合になる。

疎結合になると再利用性や、スケーラビリティが向上する上に

SWFがTaskListというキューのみを提供しているという特性上、

HTTP接続が出来れば、SWFを利用するデバイスの種類や場所（クラウドかオンプレか）を問わないので

より柔軟な構成にしやすい。

また、別ワークフローへのコンポーネント再利用やスケールアウトは

EC2のAMIを使ってサーバーの複製が簡単にできるため、SWFはEC2と相性が良かったりする。

設計例として、あるシステムから他の外部システムにPDF生成処理を要求するワークフローを考えてみる。

PDF生成処理システムが公開しているAPIを介してリクエストを送る設計だと、

PDF生成処理システムをスケールアウトする場合には

生成要求（HTTPコールアウト）に対してロードバランサーやリバースプロキシで

処理を振り分ける設計にする必要がある。

さらに、PDF生成処理システムのAPIエンドポイントが変わったり、

“要求前に要求内容を上長が確認する"等のビジネスロジックの変更があると

要求元のプログラムを変更しなければならない。

これはビジネスロジックや結合先システムに依存してしまう

密結合なシステムになっていることに起因している。

これをSWFを介して連携するように実装をすると

・スケールアップ

→コールアウト先はSWFになり変更の必要がない。

また、PDF生成の要求内容（タスク）は要求先システムによるポーリングで取得されるため

ポーリング＆タスク処理を行うサーバーを単純に複製しても正常に動く（スケールアウトが容易）。

・APIエンドポイントの変更

→要求先のシステムに依存しないため、変更の必要がない。（SWFがエンドポイント）

・ビジネスロジックの変更

→要求後に行う処理はDeciderが決定する為、Deciderのプログラムを新しいビジネスロジックに変更すれば良く、

要求元、要求先プログラムの変更の必要がない。

といったように、疎結合の恩恵が得られる。

またこういった疎結合なシステム構築により並列・結合処理を実装することも容易になる。

その場合も、ビジネスロジックを制御するDecider側プログラムの修正のみになるため

既存のタスク処理を変更する必要がない。

ちなみにSWFコンソールで実行できるサンプルプログラムは

1つのEC2インスタンスがStarter, Decider, Activity Workerを兼任していて、

JavaScript Remoting利用時のエラー

Sat, 15 Feb 2014 20:17:51 +0000

force.com開発でAjax使いたいときに重宝するJavaScript Remotingだが、

コンソール上で以下のエラーが出て動かなくなってしまった。

エラーメッセージは

“Visualforce Remoting Exception: Method ‘ScheduleActivityTaskDecision’ not found on controller SWFTestController. Check spelling, method exists, and/or method is RemoteAction annotated. "

って書いてあるが、@RemoteActionちゃんとつけてるし、クラスもメソッドもちゃんと存在しているし

VF呼び出し側には{!$RemoteAction.[controller].[method]}の形式で

グローバル変数使った書き方してて、コンパイルもちゃんと通る。

ハマりの住人になりかけたが、Google様が以下のWebサイトを紹介してくれました。

https://developer.salesforce.com/forums/ForumsMain?id=906F000000097OUIAY

http://enreeco.blogspot.jp/2013/01/apex-javascript-what-is-remoteaction.html

つまりは、定義されていない変数使うとこのエラーが出るっぽい。

boolean型のパラメータにnullを入れてもダメって書いてあったけど、私のところでは再現せず…。

ちなみに私はｊQueryで$("#hogehoge”).val()で値を取得しようとしたのは良いものの

存在しないIDを指定してたからでしたorz

force.com REST APIのOAuthエンドポイント

Thu, 13 Feb 2014 01:45:00 +0000

foce.comのREST APIではOAuth2.0を利用することができるが、

Salesforce環境やユーザによってOAuthのエンドポイントが異なっていたのでメモる。

基本的には認可のエンドポイントは

https://[domain]/services/oauth2/authorize

トークン発行のエンドポイントは

https://[domain]/services/oauth2/token

となっており、[domain]の部分がSalesforce環境やログインユーザによって変わってくる感じ。

1. 環境によるエンドポイントの違い

■Developer環境・本番環境

→login.salesforce.com

■Sandbox環境

→test.salesforce.com

■私のドメイン設定時

→私のドメインの値。

上記の環境によるドメイン値も利用できるが、

「https://login.salesforce.comからのログインを防止」にチェックがついていると

ログインされていない状態の場合は、認証画面でログインできないので

素直に私のドメインをエンドポイントにした方が良い。

2. ポータル・コミュニティユーザの場合

■ポータル

→ポータルに紐付けたSitesを設定し、そのSitesのドメイン名をエンドポイントにする。

基本的にポータルのログイン画面は

https://[domain]/secur/login_portal.jsp?orgId=[orgId]&portalId=[portalId]

の形式になっており、通常のSalesforceのログイン画面ではログインできないため、

Sitesのドメインを介してログインする方式。

詳細はこちらから。

ちなみにSOAP APIではorganizationIdやportalIdを設定可能。

■コミュニティ

→コミュニティで設定したドメイン名。

こちらはポータルと違ってドメイン名を設定が必須なので、Sitesを使う必要はない。

ポータルのSites設定方式は面倒なので、出来れば新機能のコミュニティに寄せたい感じ。

そもそも新規の環境ではコミュニティ使えないはずだし。

apex:Messageの挙動について調べてみる

Wed, 12 Feb 2014 01:59:39 +0000

force.comでフォーム的な画面を作ることはよくあると思いますが

その際にapex:inputFieldとかでVFを組んでると、必須項目の制約とかメールアドレスの形式チェックとか

Salesforceのシステムバリデーションが効いてくれる上に

型に合わせてhtmlを生成してくれるから日付型とか使うときに便利だったりします。

が、apex:inputFieldでシステムが出すバリデーションは"エラー: 値を入力してください"

というように決められた文言でしか出すことができずエラーを出す位置も決まってしまうため

Salesforceのオペレータ側ではなく対顧客に対するフォームを作成するときには

デザイン・UI的にちょっと難が…。

そこでapex:messageというのを使ってみようと思ったけど、

色々と苦戦した挙句、挙動が？だったので、ちょっと書いてみる。

パターン1. のみ

検証用VFページ↓

<apex:form>
 <apex:inputField value="{!acc.Name}"/>
 <apex:commandButton value="空送信"/>
</apex:form>

以下のように固定のエラーメッセージが出る。

このメッセージを自由に変更して、自由な位置に出力したい！というのが今回の趣旨。

パターン2. +

では実際にmessageタグを使ってみる。

検証用VF↓

<apex:form>
 <apex:inputField id="Field" value="{!acc.Name}"/>
 <apex:message for="Field"/>
 <apex:commandButton value="空送信"/>
</apex:form>

こうすると、inputFieldタグが出すエラーメッセージと

messageタグが出すエラーメッセージで2重に出力されちゃう。

パターン3. + + commandButtonのimmediate

SalesforceのSystemバリデーションを走らせないで送信したらどうなるかを検証。

<apex:form >
 <apex:inputField id="Field" value="{!acc.Name}"/>
 <apex:message for="Field"/>
 <apex:commandButton immediate="true" value="空送信" />
</apex:form>

結果、commandButtonのactionで何もしていないせいか何も出力されず…。

パターン4. + + immediate + action指定

実際にアクションでインサートしてエラーをキャッチしてページにエラーメッセージを出してみる。

検証用VF↓

<apex:form >
 <apex:pageMessages />
 <apex:inputField id="Field" value="{!acc.Name}"/>
 <apex:message for="Field"/>
 <apex:commandButton immediate="true" value="インサート" action="{!testMessage}"/>
</apex:form>

検証用Apexクラス↓

AWS CLIを使ったS3の超簡単バックアップ

Tue, 11 Feb 2014 11:18:32 +0000

業務でS3を使うことが多くなったが、

S3自体の耐久性は99.999999999%(イレブンナイン)なので問題無いとしても

プログラムやAWSコンソール画面で”うっかり削除しちゃった”系のミスがあったときに

バケットごとバックアップする機能があったら便利だなーと思って

AWS CLIのS3のサブコマンド見てたらあったので紹介！

詳細はこちらから。

1. S3のバケット内のオブジェクトをローカルPCにバックアップ

#aws s3 sync [s3 path] [local path]
aws s3 sync s3://mybucket /home/user/s3backup

用途としてはバックアップというよりは、

“S3からデータを一括で引っ張ってきて加工して再アップロード”

みたいなことをするときに便利。

オブジェクトキーのセパレータがスラッシュ(/)の場合は自動的にディレクトリを作って階層構造にしてくれる。

2. S3のバケット内のデータを別のバケットにバックアップ

#aws s3 sync [s3 path<from>] [s3 path<to>]
aws s3 sync s3://mybucket s3://backup

バックアップに使える以外には、テスト環境と本番環境のデータを同期する時など

複製して使いたい場合に有効。

異なるリージョン間でも同期できたので、S3を使っててレイテンシを考慮する場合は使えるかも！？

S3使っててレイテンシ考慮するケースってほとんどCloudFront 使っちゃうと思うけど…。

3. ローカルのデータをS3にバックアップ

#aws s3 sync [local path] [s3 path]
aws s3 sync /home/user/data s3://mybucket

バックアップのクラウドのデータストレージとしてS3を利用する場合に有効。

–deleteオプションを付けるとローカルに存在しないファイルは自動的にS3バケット上で削除してくれる。

うまく使えば簡易的なDropbox的なこともできるかも！？

こんな感じでAWS CLIは簡単にインストールできて、簡単に使えて

bashに組み込めるから少々テクニカルなこともできちゃうのでオススメです！

herokuのpostgreSQLへのデータ移行

Tue, 28 Jan 2014 23:59:22 +0000

herokuからpostgreSQLのデータ移行の方法をまとめてみる。

方法としては以下の２つがあるみたい。

pg:pushでローカルのレコードまるごとインポート
標準入力からpsqlコマンドでインポート

1. pg:pushを使う

この方法はローカルのpostgreSQLデータベースのデータをそのままherokuに反映するような方法。

具体的には

heroku pg:reset DATABASE_URL
PGUSER=postgres　heroku pg:push [MyLocalDBName] DATABASE_URL

とheroku側のDBをリセットして、ローカルのDBをインポートする感じ。

この方法の詳細はこちらから。

2. ローカルDBのdumpからリストアする。

ローカルDBのdumpを作成し、s3等のWebリソースに置き、heroku側postgreSQLからこのdumpを使ってリストアする方式。

s3とかのオープンなスペースに置くとなると一時的とはいえセキュリティ的にどうなの？って印象。

詳細はこちら。

3. psqlからインポート

psqlコマンドでherokuのpostgreSQLにログインして、インポート対象のCSVファイルに対してcopyコマンドを打つと、herokuのpostgresユーザがsuperuserでない為に「ローカルからファイルを読み込めない」的なエラーになってしまう。

ただし、標準入力からだといけるので

cat [target csv file path] | psql -U [heroku user name] \
-W -h [heroku host name] [heroku db name] -c "copy hoge(fuga1, fuga2, fuga3) from stdin with csv"

とやればインポート可能。

herokuのホスト名やユーザ名等はherokuのpostgreSQL設定画面から取得する。

参考URLはこちら。

ところで、一括更新する場合（例えばマスタの更新とか）ってどうするんだろ？

Salesforce開発を効率化するUserScriptを作ってみた。

Sun, 26 Jan 2014 21:24:34 +0000

いや、言うほど効率化しないですがｗ

ApexからSharepointのREST APIを触ってみる。

Sat, 25 Jan 2014 00:34:06 +0000

毎度恒例Apexから触ってみるシリーズ。前回はSharepointのREST APIの解説をしたので、今回は実際にApexからコールしてみます。

SharepointのREST APIのリファレンスが不親切だったので簡潔に(?)書いてみる。

Tue, 21 Jan 2014 00:23:24 +0000

MicrosoftのサービスのSharepointにREST APIで接続しようとリファレンス見たら、全然わからなかったので、簡潔に書いてみます。

WindowsからSambaに繋ごうと思ったらクソハマった話

Sat, 11 Jan 2014 23:42:03 +0000

WindowsからSambaサーバ(VM)に繋ごうとしたときにクソハマったのでそのお話。

ApexからSTS触ってみる。

Wed, 08 Jan 2014 00:50:59 +0000

例のごとくApexからSTSを触ってみました。

SalesforceからAWSにAssumeRoleWithSAMLをコールするときの注意点

Sun, 05 Jan 2014 21:40:27 +0000

この記事を参考にSalesforceからAWSにSAMLAssertionを投げて、AWSのコンソール画面にシングルサインオンするっていうのは出来たが、対象のRoleの一時的なAccessKeyIdやSecretAccessKeyを取得するためのAssumeRoleWithSAML のREST APIが通そうとしたところ、こんな感じのエラーが出てしまった。

SNSのHTTP通知のハンドラーをforce.com Sitesで作ってみる。

Sat, 04 Jan 2014 12:21:07 +0000

SNSのHTTP通知ハンドラーをforce.com Sitesで作って、HTTP通知の中でTwilio API呼び出してSMS送信するような処理を作ってみました。

SNSからSMS送信できるのは米国の電話番号だけっぽいので日本の電話番号に対応できるように、Twilio API経由でSMS送信するっていうのが目的。

SitesでanonymousなREST APIをコールする。

Fri, 03 Jan 2014 12:02:51 +0000

SNS(AWS)のHTTPハンドラーとしてforce.com Sitesを使おうと思って、Visualforce + Apexで試行錯誤したものの、PageReferenceのgetParametersはhttpのrequestBodyを取ってくるわけじゃなく、key=value形式のパラメータしか取ってこれません。つまりVFを使った方法だとJSONをrequestBodyに持ってくるようなSNSのNotificationには対応していません。

Salesforceのパッケージインストール時の謎のエラーについて

Fri, 03 Jan 2014 00:41:38 +0000

AWSのToolkitとかTwilioのライブラリをインストールしようとしたときに、

あるDeveloper環境ではエラーが起きてインストールできず、他の環境ではインストール出来るという

謎の現象が起きてしまった。

パッケージインストールでは詳細なエラーメッセージが出ないっぽいので

インストールできた他の環境からインストールしたい対象の環境に対して

パッケージのコンポーネントを丸ごとデプロイしてみて、エラーが出るか確認。

そしたら、以下のエラーメッセージが出てデプロイ失敗しました。

[Test.isRunningTest method does not exist]

「いやいや、Test.isRunningTestはメソッドとして存在するでしょ。」

「他の環境でインストールできているってことはapex versionも問題ないだろうし。」

とか小賢しいこと思って色々調べたらdeveloer forumにこんな記事が…。

https://developer.salesforce.com/forums?id=906F00000008zvnIAA

ということで、testっていうクラスがあったせいでした。そりゃそうだよな…。

apexは大文字小文字区別しないからtestであろうとTestであろうと見事に引っかかります。

testクラスからTestApexクラスに変更したら無事インストール出来ました。

Developer環境でTest.isRunningTestを使ってなかったし、

そもそも検証用環境だからテストクラス回したりなんて滅多にしないから気付かなかった…。

ちなみにTest.isRunningTest()じゃなくてSystem.Test.isRunningTest()っていう風に

Systemっていう名前空間的なものをつけてあげれば既存のTestっていうクラスを消さずにもイケるっぽい。

Testっていうクラスに

public static Boolean isRunningTest() {
 return System.Test.isRunningTest();
}

っていうメソッド持たせるのもOK。

今回はパッケージであんまりコードを修正したくなかったし、

Testっていうクラスをリネームしても問題なかったので良かったけど

どうしてもリネームできない理由があるのであれば上記2つの手段を使うのもOKだと思います。

どんな組織にも入れることが出来るようなパッケージを作る場合は

パッケージのクラスのSystemっていう名前空間がつくものには全てSystem名前空間を付与した方が良さそう。

ApexからTwilio APIを叩く！

Thu, 02 Jan 2014 18:19:28 +0000

巷で有名なTwilioをapexから触ってみた。

Twilioとは、Web技術で電話やSMS送信が出来るサービス。

REST APIがサポートされていて

例のごとくREST APIをラッピングしている各々のプログラム言語のライブラリ(Helperライブラリ)も公開されてます。

サポートされているプログラミング言語では珍しくapex(force.com)も利用できるので、今回カンタンに触ってみた。

使い方のドキュメントとgithubのURLはこちら↓

https://twilio-salesforce.readthedocs.org/en/latest/

https://github.com/twilio/twilio-salesforce

まずはTwilioのアカウントを取得して電話番号を購入する。

※現在、日本の電話番号だとSMSを送信できないので、SMS送信する場合は、アメリカあたりの海外の電話番号をTwilioで取得する必要があります。

その後、パッケージリンクからSalesforce環境にオブジェクトやらクラスをインストール↓

https://login.salesforce.com/packaging/installPackage.apexp?p0=04ti0000000XkE0

そのあと、Twilio Configというカスタム設定（リスト）で適当にレコードを作成して、

AccountSidとAuthTokenにTwilioダッシュボードで表示されている値をセットする。

あとは、コードを書くだけ！

電話かけるとき

TwilioRestClient client = TwilioAPI.getDefaultClient();
TwilioCall call = client.getAccount().getCalls().create(new Map<String, String>{
 'To' => 'Input Your To Phone Number(E.164)',
 'From' => 'Input Your From Phone Number(E.164)',
 'Url' => 'Input Your TwiML url for Call'
});

salesforceでfacebook, google, salesforceを認証プロバイダにしてSSOしてみる。

Tue, 31 Dec 2013 22:28:48 +0000

facebook, google, salesforceを認証プロバイダにしてシングルサインオンが簡単にできるみたいなので試してみた。

（facebookとかにログインすると自動的にsalesforceにログインする的な感じ）

salesforceを認証プロバイダにする場合は別salesforce環境を用意する必要があります。

salesforceを認証プロバイダってなんだそりゃ？って思いましたが

多分、お客さんがSalesforce環境をすでに使っていて

カスタマーコミュニティとかでそのお客さんを管理する場合に利用するものなんだと思います。

以下、参考URL↓

http://www.slideshare.net/DeveloperForceJapan/webinar-13324430

http://tyoshikawa1106.hatenablog.com/entry/2013/06/02/212452

https://help.salesforce.com/HTViewHelpDoc?id=sso_provider_facebook.htm&language=ja

https://developers.google.com/accounts/docs/OpenID?hl=ja

facebook

1. facebookアプリを登録

セキュリティのコントロール＞認証プロバイダ　で新規認証プロバイダを作成
2でコールバックURLが自動生成されるので、1のアプリにコールバックURLを設定

([Facebookでログインが可能なウェブサイト]の[サイトURL]に設定する。)

以下、設定例

google

1. Google Developers ConsoleにアクセスしてProjectを作成し、Google+APIを有効化

セキュリティのコントロール＞認証プロバイダ　で新規認証プロバイダを作成
2でコールバックURLが自動生成されるので、1のアプリにコールバックURLを設定

(APIs & auth > CredentialsのOAuthセクションでRedirect URIsを設定)

以下、設定例

途切れているユーザ情報エンドポイントURLはhttps://www.googleapis.com/plus/v1/people/me/openIdConnect　です。

Salesforce

1. 別組織のSalesforceの作成＞アプリケーションにアクセスして、接続アプリケーション(OAuth)を作成

セキュリティのコントロール＞認証プロバイダ　で新規認証プロバイダを作成
2でコールバックURLが自動生成されるので、1のアプリにコールバックURLを設定

以下、設定例

2014

Wed, 01 Jan 2014 00:00:00 +0900

OpenAMでSSO【IdP Initiated SSO】

Sun, 29 Dec 2013 22:09:38 +0000

前回はSP initiated SSOで

SPにアクセス
リダイレクトとかPOSTとかでIdPにアクセス[SAMLリクエスト]
IdPに対して認証処理
認証OKならSPにSAMLレスポンスを返してSP側の認証も完了

というフローでしたが、今回はIdP initiated SSOをやってみます。

apexからSimpleDB触ってみる。

Sun, 29 Dec 2013 02:23:08 +0000

例のごとくapexからSimpleDB触ってみる。

/**
 * SimpleDBのコモンクラス
 */
public with sharing class SimpleDBCommon {
 /**
 * AccessKey
 */
 public String AWSAccessKeyId = EnvSetting__c.getOrgDefaults().AWSAccessKeyId__c;

 /**
 * SecretKey
 */
 public String AWSSecretKeyId = EnvSetting__c.getOrgDefaults().AWSAccessKeySecret__c;

 /**
 * ドメイン作成
 */
 public String createDomain(String domainName) {
 Map<String, String> params = new Map<String, String>{
 'Action' => 'CreateDomain',
 'AWSAccessKeyId' => this.AWSAccessKeyId,
 'SignatureMethod' => 'HmacSHA256',
 'SignatureVersion' => '2',
 'DomainName' => domainName,
 'Version' => '2009-04-15',
 'Timestamp' => DateTime.now().formatGmt('YYYY-MM-dd') + 'T' + DateTime.now().formatGmt('HH:mm:ssZ')
 };

 params.put('Signature', this.createSignature('POST', 'sdb.amazonaws.com', '/', params));

 HttpRequest req = new HttpRequest();
 req.setEndpoint('https://sdb.amazonaws.com');
 req.setMethod('POST');

 req.setBody(Utility.getSortedParam(params));
 Http http = new Http();
 HTTPResponse res = http.send(req);

 return res.getBody();
 }

 /**
 * ドメイン削除
 */
 public String deleteDomain(String domainName) {
 Map<String, String> params = new Map<String, String>{
 'Action' => 'DeleteDomain',
 'AWSAccessKeyId' => this.AWSAccessKeyId,
 'SignatureMethod' => 'HmacSHA256',
 'SignatureVersion' => '2',
 'DomainName' => domainName,
 'Version' => '2009-04-15',
 'Timestamp' => DateTime.now().formatGmt('YYYY-MM-dd') + 'T' + DateTime.now().formatGmt('HH:mm:ssZ')
 };

 params.put('Signature', this.createSignature('POST', 'sdb.amazonaws.com', '/', params));

 HttpRequest req = new HttpRequest();
 req.setEndpoint('https://sdb.amazonaws.com');
 req.setMethod('POST');

 req.setBody(Utility.getSortedParam(params));
 Http http = new Http();
 HTTPResponse res = http.send(req);

 return res.getBody();
 }

 /**
 * アイテム作成
 */
 public String putAttributes(String domainName, String itemName, Map<String, String> attributes) {
 Map<String, String> params = new Map<String, String>{
 'Action' => 'PutAttributes',
 'AWSAccessKeyId' => this.AWSAccessKeyId,
 'SignatureMethod' => 'HmacSHA256',
 'SignatureVersion' => '2',
 'DomainName' => domainName,
 'Version' => '2009-04-15',
 'Timestamp' => DateTime.now().formatGmt('YYYY-MM-dd') + 'T' + DateTime.now().formatGmt('HH:mm:ssZ'),
 'ItemName' => itemName
 };

 Integer i = 1;
 for (String key : attributes.keySet()) {
 	params.put('Attribute.' + i + '.Name', key);
 params.put('Attribute.' + i + '.Value', attributes.get(key));
 i++;
 }

 params.put('Signature', this.createSignature('POST', 'sdb.amazonaws.com', '/', params));

 HttpRequest req = new HttpRequest();
 req.setEndpoint('https://sdb.amazonaws.com');
 req.setMethod('POST');

 req.setBody(Utility.getSortedParam(params));
 Http http = new Http();
 HTTPResponse res = http.send(req);

 return res.getBody();
 }

 /**
 * クエリ
 */
 public String query(String queryString) {
 Map<String, String> params = new Map<String, String>{
 'Action' => 'Select',
 'AWSAccessKeyId' => this.AWSAccessKeyId,
 'SignatureMethod' => 'HmacSHA256',
 'SignatureVersion' => '2',
 'SelectExpression' => queryString,
 'Version' => '2009-04-15',
 'Timestamp' => DateTime.now().formatGmt('YYYY-MM-dd') + 'T' + DateTime.now().formatGmt('HH:mm:ssZ')
 };

 params.put('Signature', this.createSignature('POST', 'sdb.amazonaws.com', '/', params));

 HttpRequest req = new HttpRequest();
 req.setEndpoint('https://sdb.amazonaws.com');
 req.setMethod('POST');

 req.setBody(Utility.getSortedParam(params));
 Http http = new Http();
 HTTPResponse res = http.send(req);

 return res.getBody();
 }

 private String createSignature(
 String method,
 String hostname,
 String resource,
 Map<String, String> params
 ) {
 String signature = 
 method + Constants.LF +
 hostname.toLowerCase() + Constants.LF +
 resource + Constants.LF +
 Utility.getSortedParam(params);
 System.debug(signature);
 return String.valueOf(EncodingUtil.base64Encode(
 Crypto.generateMac(
 'hmacSHA256', 
 Blob.valueOf(signature),
 Blob.valueOf(this.AWSSecretKeyId)
 )
 ));
 }
}

/**
 * Utilityクラス
 */
public without sharing class Utility {
 public static List getSortedList(Set keys) {
 List sortedList = new List();
 sortedList.addAll(keys);
 sortedList.sort();
 return sortedList;
 }

 /**
 * key=value&...でつないだ文字列を返却
 * @param mapParam 対象文字列=>文字列マップ
 * @return key=value&...でつないだ文字列
 */
 public static String getSortedParam(Map<String,String> mapParam){
 if (mapParam == null || mapParam.keySet().isEmpty()) {
 return '';
 }
 String param = '';
 List sortedKey = getSortedList(mapParam.keySet());
 for(String key: sortedKey){
 param += percentEncodeRfc3986(key) + '=' + percentEncodeRfc3986(mapParam.get(key)) + '&';
 }
 return param.substring(0,param.length() - 1);
 }

 public static String percentEncodeRfc3986(String s) {
 return EncodingUtil.urlEncode(s, 'UTF-8')
 .replace('+', '%20')
 .replace('*', '%2A') 
 .replace('%7E', '~');
 }
}

herokuでdjango動かしてみる。

Sat, 28 Dec 2013 17:30:23 +0000

この冬はLPICの受験勉強！

→スマホとかPCから勉強できる自分用の単語帳的なアプリが欲しい！

→Androidアプリ開発者レベル1だからとりあえずWebアプリで早急に作ろう！

→手軽にホスティングできて、手軽に作れるフレームワークで！

→heroku + python + django！

ということで、linux環境からherokuでdjango動かすまでの備忘録。っていうかherokuガイドの日本語訳ｗ

詳しいやり方はherokuのstartガイド参照↓

https://devcenter.heroku.com/articles/getting-started-with-django

ちなみにdjangoデプロイするときにherokuのwsgirefのpipインストールの時に

python3系だと何故かコケちゃうので、バージョンは2.7でデプロイしてます。

pipとかのインストール

wget -qO- https://toolbelt.heroku.com/install-ubuntu.sh | sh
apt-get install python-setuptools python-pip python-dev python-psycopg2 libpq-dev
virtualenv venv --python=/usr/bin/python --distribute
source venv/bin/activate
pip install django-toolbelt

※もしかしたらpython-setuptoolsインストールしなくてもイケるかも。

※sudo pip installとかやるとルートユーザ権限で実行される関係で、venvの環境外にインストールされちゃうっぽい。

djangoアプリ作成

django-admin.py startproject hellodjango

3.Procfile（設定ファイル）作成

cd hellodjango
vim Procfile

で、以下を入力↓

web: gunicorn hellodjango.wsgi

django起動確認

foreman start

でブラウザでhttp://localhost:5000を開き、“It Worked!“が出ていることを確認。

インストールされているパッケージ一覧をrequirements.txtに記述

pip freeze > requirements.txt

あとはお馴染みのherokuのデプロイコマンド

git init
git add .
git commit -m "Message"
heroku create
git push heroku master

apexからDynamoDB触ってみる。

Wed, 25 Dec 2013 01:40:12 +0000

巷で有名なDynamoDBさんにApexから触ってみました。

apexからAmazon Elastic Transcoderを触ってみる。

Mon, 23 Dec 2013 22:40:08 +0000

Amazon Elastic TranscoderとはAmazon Web Serviceの一つ(ベータ版)で

メディア変換をできるクラウドサービス。

あんまりメディアファイルを扱ったこと無いから利用イメージが湧かないが、

iOS用のストリーミング技術のHLSへの変換が簡単そうなので触ってみることにした。

基本的な使い方は安定のクラスメソッドさんのブログで↓

http://dev.classmethod.jp/cloud/amazon-elastic-transcoder-start/

http://dev.classmethod.jp/references/amazon-elastic-transcoder-hls/

一般的なWeb言語のSDKは存在するものの、apex用のSDKはもちろん無いので

pipeline(入出力バケットの設定)とjob(実際の変換操作)の作成部分を作ってみた。

/**
 * AETコモンクラス
 */
public with sharing class AETCommon {
	private final String SERVICE = 'elastictranscoder';

 /**
 * Access Key Id
 */
 private String AWSAccessKeyId = EnvSetting__c.getOrgDefaults().AWSAccessKeyID__c;

 /**
 * Access Key Secret
 */
 private String AWSAccessKeySecret = EnvSetting__c.getOrgDefaults().AWSAccessKeySecret__c;

 /**
 * パイプラインを作成
 */
 public String createPipeLine(
 String region, 
 String pipelineName,
 String inputBucket,
 String outputBucket,
 String thumnailBucket,
 String role
 ) {
 Map<String, String> params = new Map<String, String>{

 };

 List<String> signedHeaders = new List<String>{
 'host', 'x-amz-date'
 };

 DateTime dt = DateTime.now();
 String credentialScope = dt.formatGmt('YYYYMMdd') + '/' + 
 region + '/' + SERVICE + '/aws4_request';

 //Body
 Map<String, Object> jsonMap = new Map<String, Object>{
 'Name' => pipelineName,
 'InputBucket' => inputBucket,
 'OutputBucket' => outputBucket,
 'Role' => role,
 'Notifications' => new Map<String, Object>{
 	'Progressing' => '',
 	'Completed' => '',
 	'Warning' => '',
 	'Error' => ''
 }
 };
 String jsonBody = Json.serialize(jsonMap);

 String resource = '/2012-09-25/pipelines';

 String stringToSign = this.createStringToSign(
 'AWS4-HMAC-SHA256',
 dt, 
 credentialScope, 
 this.createHashedCanonicalRequest(
 'SHA256',
 'POST',
 resource,
 params,
 new Map<String, String>{
 'Host' => 'elastictranscoder.' + region + '.amazonaws.com',
 'x-amz-date' => dt.formatGmt('YYYYMMdd') + 'T' + dt.formatGmt('HHmmss') + 'Z'
 },
 signedHeaders,
 jsonBody
 )
 );

 String signature = this.createSignature(
 'hmacSHA256',
 dt,
 region,
 SERVICE,
 Blob.valueOf(stringToSign)
 );

 return this.callCommonAETCall(
 dt,
 'elastictranscoder.' + region + '.amazonaws.com',
 credentialScope,
 signedHeaders,
 signature,
 resource,
 jsonBody
 );
 }

 /**
 * jobを作成
 */
 public String createJob(
 String region, 
 String pipelineId,
 String inputKey,
 String outputKey,
 String outputKeyPrefix
 ) {
 	Map<String, String> params = new Map<String, String>{

 	};

 List<String> signedHeaders = new List<String>{
 'host', 'x-amz-date'
 };

 	DateTime dt = DateTime.now();
 	String credentialScope = dt.formatGmt('YYYYMMdd') + '/' + 
					 region + '/' + SERVICE + '/aws4_request';

 //Body
 Map<String, Object> jsonMap = new Map<String, Object>{
 	'PipelineId' => pipelineId,
 'Input' => new Map<String, Object>{
 'Key' => inputKey
	 },
	 'Outputs' => new List<Map<String,Object>>{
	 	new Map<String, Object>{
	 		'Key' => outputKey,
	 		'PresetId' => '1351620000001-200050',
	 		'SegmentDuration' => '5'
	 	}
	 },
	 'OutputKeyPrefix' => outputKeyPrefix
 	};
 	String jsonBody = Json.serialize(jsonMap);

 String stringToSign = this.createStringToSign(
 'AWS4-HMAC-SHA256',
 dt, 
 credentialScope, 
 this.createHashedCanonicalRequest(
 'SHA256',
 'POST',
 '/2012-09-25/jobs',
 params,
 new Map<String, String>{
 'Host' => 'elastictranscoder.' + region + '.amazonaws.com',
 'x-amz-date' => dt.formatGmt('YYYYMMdd') + 'T' + dt.formatGmt('HHmmss') + 'Z'
 },
 signedHeaders,
 jsonBody
 )
 );

 String signature = this.createSignature(
 'hmacSHA256',
 dt,
 region,
 SERVICE,
 Blob.valueOf(stringToSign)
 );

 return this.callCommonAETCall(
	 dt,
	 'elastictranscoder.' + region + '.amazonaws.com',
	 credentialScope,
	 signedHeaders,
	 signature,
	 '/2012-09-25/jobs',
	 jsonBody
	 );
 }

 /**
 * AETへのAPIコールの共通メソッド
 */
 private String callCommonAETCall(
 DateTime dt,
 String hostname,
 String credentialScope,
 List<String> signedHeaders,
 String signature,
 String resource,
 String jsonBody
 ) {
 	HttpRequest req = new HttpRequest();
 req.setHeader('Host', hostname);
 req.setHeader(
 'x-amz-date', 
 dt.formatGmt('YYYYMMdd') + 'T' + dt.formatGmt('HHmmss') + 'Z'
 );

 req.setHeader('Content-Type', 'application/json; charset=UTF-8');
 req.setHeader('Content-Length', String.valueOf(jsonBody.length()));

 req.setHeader(
 'Authorization',
 'AWS4-HMAC-SHA256 Credential=' + this.AWSAccessKeyId + '/' + credentialScope + ',' +
 'SignedHeaders=' + String.join(Utility.getLowerCaseSortedList(signedHeaders), ';') + ',' + 
 'Signature=' + signature
 );
 req.setEndpoint('https://' + hostname + resource);
 req.setMethod('POST');

 req.setBody(jsonBody);

 Http http = new Http();
 HTTPResponse res = http.send(req);
 return res.getBody();
 }

 /**
 * HashedCanonicalRequestを作成
 */
 private String createHashedCanonicalRequest(
 String algorithm,
 String method,
 String url,
 Map<String, String> params,
 Map<String, String> headers,
 List<String> signedHeaders,
 String payload
 ) { 	
 String signature = '';
 signature += method + Constants.LF;
 signature += url + Constants.LF;
 signature += Utility.getSortedParam(params) + Constants.LF;
 signature += Utility.createCanonicalHeaders(headers) + Constants.LF;
 signature += String.join(Utility.getLowerCaseSortedList(signedHeaders), ';').toLowerCase() + Constants.LF;
 signature += EncodingUtil.convertToHex(
 Crypto.generateDigest(
 algorithm,
 Blob.valueOf(payload)
 )
 );
 return EncodingUtil.convertToHex(
	 Crypto.generateDigest(
	 algorithm, 
	 Blob.valueOf(signature)
	 )
	 ).toLowerCase();
 }

 /**
 * StringToSignを作成
 */
 private String createStringToSign(
 String algorithm,
 DateTime requestDateTime,
 String credentialScope,
 String hashedCanonicalRequest
 ) {
 	String stringToSign = algorithm + Constants.LF;
 	stringToSign += 
 	 requestDateTime.formatGmt('YYYYMMdd') + 'T' + 
 	 requestDateTime.formatGmt('HHmmss') + 'Z' + Constants.LF;
 stringToSign += credentialScope + Constants.LF;
 stringToSign += hashedCanonicalRequest;
 return stringToSign; 	
 }

 private String createSignature(
 String algorithm,
 DateTime requestDateTime,
 String region,
 String service,
 Blob stringToSign
 ) {
 	system.debug(stringToSign.toString());
 	Blob kDate = Crypto.generateMac(
			algorithm,
			Blob.valueOf(requestDateTime.formatGmt('YYYYMMdd')),
 Blob.valueOf('AWS4' + this.AWSAccessKeySecret)
 );
 Blob kRegion = Crypto.generateMac(
 algorithm,
 Blob.valueOf(region),
 kDate
 );
 Blob kService = Crypto.generateMac(
 algorithm,
 Blob.valueOf(service),
 kRegion
 );

 Blob kSigning = Crypto.generateMac(
 algorithm,
 Blob.valueOf('aws4_request'),
 kService
 );

 return EncodingUtil.convertToHex(
 Crypto.generateMac(
		algorithm,
		stringToSign,
 kSigning
 )
 );
 }
}

/**
 * Utilityクラス
 */
public without sharing class Utility {
 /**
 * key=value&...でつないだ文字列を返却
 * @param mapParam 対象文字列=>文字列マップ
 * @return key=value&...でつないだ文字列
 */
 public static String getSortedParam(Map<String,String> mapParam){
 if (mapParam == null || mapParam.keySet().isEmpty()) {
 return '';
 }
 String param = '';
 List sortedKey = getSortedList(mapParam.keySet());
 for(String key: sortedKey){
 param += percentEncodeRfc3986(key) + '=' + percentEncodeRfc3986(mapParam.get(key)) + '&';
 }
 return param.substring(0,param.length() - 1);
 }

 public static String percentEncodeRfc3986(String s) {
 return EncodingUtil.urlEncode(s, 'UTF-8')
 .replace('+', '%20')
 .replace('*', '%2A') 
 .replace('%7E', '~');
 }

 public static String createCanonicalHeaders(Map<String, String> headers) {
 	if (headers == null || headers.keySet().isEmpty()) {
 return '';
 }

 Map<String, String> lowerCaseHeaders = new Map<String, String>();
 	for (String key : headers.keySet()) {
 		lowerCaseHeaders.put(key.toLowerCase(), headers.get(key));
 	}
 	String param = '';
 List sortedKey = getSortedList(lowerCaseHeaders.keySet());
 for(String key: sortedKey){
 param += key + ':' + lowerCaseHeaders.get(key).trim() + '\n';
 }
 return param;
 }

 public static List getLowerCaseSortedList(List keys) {
 	List sortedKeys = new List();
 for (String key : keys) {
 	sortedKeys.add(key.toLowerCase());
 }
 sortedKeys.sort();
 return sortedKeys;
 }
}

freedom-man.com

2025年の振り返り

仕事

アウトプット

育児

旅行

飲み会

今年の振り返り＆来年に向けて

Salesforceはなぜ負債になりやすいのか

1. DMLをフックとした機能全般

2. データの取り回しのしづらさ

3. Apex/VF/LWCなどの開発・保守性が悪くなりがちな機能

前提を変える力

前提を変えれないと戦略を間違う

フルスタックとフルサイクル

技術に依らない

たたき台のお作法

たたき台がなぜ必要なのか

何を使ってたたき台を作るか

タスクを洗い出すためのたたき台

要件定義のためのたたき台

設計を議論するためのたたき台

作った「たたき台」を自分の言葉で話せるようにする

作った「たたき台」にこだわらない

細部にこだわらない。スピードが大事

ビジネスモデルと労働集約

IT業界におけるビジネスモデル

ソフトウェアエンジニアとしてこれをどう解釈して動いていくべきか

余談

DBテストのデータ管理はトランザクション/ロールバック方式にしたい

理由1: 高速である

理由2: 並列性が高い

理由3: データのcleanupが簡単

各言語/フレームワークでは何を使うか

[小ネタ] Laravelではdisplay_errorsはOffになる

PHPStan導入・運用ガイド

PHPStan とは

Rectorの使い方とサンプル

Rectorとは

使い方

rector.phpサンプル

自動で型付けしたい

旧Factoryから新Factoryに移行したい

ルーティングの記述方法を配列方式に変更

関連URL

Next.jsのServer ActionsでCloud Tasksを呼び出すときはバンドル対象から除外する

NextAuth.jsで代理ログインを実装する方法

Cloud RunでCloud SQL接続するときは接続待機が必要

ロールをあえて決めるかどうか

Laravelのconfig()のカスタム値は環境依存の値にすべき

メッセージ配信系バッチ実装ガイドライン

[MUST] テストを書く

[MUST] dry runできるようにする

[SHOULD] 誰に送信したのかをIDなどでロギングしておく

[MUST] 初回稼働時は実行に立会ってログの確認を行う

[SHOULD] 本番・テスト環境で処理を差し替える

開発サーバーではMailのドライバーをlogにする

[MUST] ホワイトリスト方式のチェックを入れる

[MUST] API呼び出しの共通パラメータを環境変数化して切り替え

Laravelの各環境を視覚的に判別する

MVCでええやん

MVCを使うときの大まかな設計の流れ

基本形（バリデーション＋保存）

バリデーションが増えてきたら…

保存時の変換ロジックなどが増えてきたら…

もっと固有のロジックが増えてきてModelが太ってきたら…

Fat Controllerでもええやん

そのデータソース切り替えは本当にあるのか？

拡張性よりスピード感を大事にしたい

その拡張性の効果が出るのは「いつ」か？

そのときに変更できるのか？という判断軸

拡張性よりもスピード

useEffectのdependenciesに配列値を指定している場合の挙動

useEffectのdependenciesと配列値

ReactでEnterキーでサブミットする方法

formタグを使う

onKeyDownでEnterキーの処理する

依存パッケージのLICENSEを調べる方法

PHP

JavaScript

`var` ではなく `let` `const` を使う

ログ・アラートガイドライン