私が歌川です

@utgwkk が書いている

nginx の $request_uri と $uri

技術

nginxの $request_uri と $uri は似ているけどちょっと違う。

$request_uri

$request_uri
full original request URI (with arguments)

  • クエリパラメータ付きのオリジナルのURI

$uri

$uri
current URI in request, normalized

The value of $uri may change during request processing, e.g. when doing internal redirects, or when using index files.

  • 正規化されたURI
  • リクエストの処理過程で $uri の値は変わりうる
  • クエリパラメータは付いてない

どのように正規化されるのか

locationディレクティブに書いてある。

The matching is performed against a normalized URI, after decoding the text encoded in the “%XX” form, resolving references to relative path components “.” and “..”, and possible compression of two or more adjacent slashes into a single slash.

  • パーセントエンコーディングの文字列をデコードする
  • 相対パスを解決する
  • merge_slashes on なら、2つ以上のスラッシュが隣接してたら1つにまとめる

見比べる

merge_slashes on;
log_format hoge "$request\trequest_uri:$request_uri\turi:$ur";
# 中略
access_log /var/log/nginx/access.log hoge;

のように設定して、/foo/bar/baz///こんにちは?hoge=2 にアクセスし、ログを見る*1。

GET /foo/bar/baz///%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF?hoge=2 HTTP/1.1     request_uri:/foo/bar/baz///%E3%81%93%E3%82%93%E3%81%AB%E3%81%A1%E3%81%AF?hoge=2      uri:/foo/bar/baz/\xE3\x81\x93\xE3\x82\x93\xE3\x81\xAB\xE3\x81\xA1\xE3\x81\xAF

たしかに $uri は正規化されてるしクエリパラメータが付いてない。

consistent hashでupstreamへのリクエストを振り分けるときや、アクセスログに記録するときにうまく使い分ける必要がありそう。

参考

*1:相対パスの部分はリクエストする前にChromeやcurlが解決しているようだった

■

早寝すると調子がいい気がする。

月曜日は二日酔いデバフもあってまったく捗らず、これはもうどうしようもない、と諦めて21時に就寝したところ、翌日には体力回復した。 昨日も22時に寝て早起きして、洗濯も掃除もやって調子いい出だしになっている。

夜型人間ってよく言われるけど、寝るのを惜しんでたら翌朝調子が出なかったのの積み重ねだったのかもしれない。

VSCodeの拡張機能を書くときに見るページ

技術

VSCodeの拡張機能を書くことがまあまああるのだけれど、毎回 vscode extension api hogehoge みたいな検索ワードで検索しまくっているので、普段どういうページを見ながら拡張機能を書いているのかまとめることにした。

utgwkk.hateblo.jp

utgwkk.hateblo.jp

Contribution Points

code.visualstudio.com

package.jsonにcontributesといって、拡張機能が提供する機能について書かないといけないのだけれど、何をどのように書いたらよいかを調べるときに見る。

VS Code API

code.visualstudio.com

とにかく拡張機能を実装するのに利用できるAPIを確認するときに見る。 型定義を見たり、このページをgrepしたりしてちょうどよいAPIを探すことができる。

Publishing Extnsions

code.visualstudio.com

vsce コマンドで拡張機能を公開できるけど、そのときに使う認証方法について書いてある。

github.com/microsoft/vscode-extension-samples

APIあるのは分かったけどどうやって使えばいいの？？？ となったとき、ここに使用例がいっぱいあるので見る。

github.com

GitHubで使いたいAPIで検索する

samplesにもないAPIを使いたいけどみんなどうやって使っているの？？ とか、packages.json結局どういうことを書けばいいの？ となったときに見る。

NodeJSのAPIリファレンス

VSCode拡張はTypeScriptで書けて、NodeJSで動いてるのでNodeJSのAPIが使える。 おもむろにchlid_processで外部コマンド叩くみたいなのもできる。 エディタにいいAPIがなさそうだったらNodeJSのAPIでなんとかする、みたいなことが可能。