Web - 版の履歴

Senooken: Substitution

2025-10-14T08:20:43Z

Substitution

@@ 2,018行目: / 2,018行目: @@
   RewriteCond %{REQUEST_FILENAME} !-f
   RewriteRule ^(.*)$ /index.php [L,QSA,B]
 ====== Flags ======
@@ 2,035行目: / 2,050行目: @@
 あまり使わない。
 * UnsafeAllow3F: 基本は使わない。Apache v2.2までは、URLクエリー文字列内部に?がある場合、バックリファレンスで?がそのままだった。が、v2.4からはエンコードして%3Fにしている。この動きが困る場合だけつける。レガシー互換用。本来ならアプリで対応すべき内容。

Senooken: 例

2025-10-14T08:10:53Z

例

@@ 2,005行目: / 2,005行目: @@
 mod_rewriteのコア。マッチしたパターンを置換先にリダイレクトする。
   RewriteRule Pattern Substitution [flags]
 ====== Flags ======
@@ 2,050行目: / 2,063行目: @@
   RewriteCond %{HTTP_REFERER} !^https?://(www\.)?example\.com/ [NC]
   RewriteRule \.(jpg|png|gif)$ - [NC,F,L]
 ====== 変数 ======
@@ 2,161行目: / 2,179行目: @@
 trace8=debug未満では、何のログも出力しない。2超過は性能が落ちるのでデバッグ用にだけ使う。
 ==== auth ====
 [https://httpd.apache.org/docs/2.4/ja/howto/auth.html 認証、承認、アクセス制御 - Apache HTTP サーバ バージョン 2.4]

Senooken: /* Flags */

2025-10-14T07:55:26Z

Flags

← 古い版		2025年10月14日 (火) 16:55時点における版
2,013行目:		2,013行目:
	* L\|last: これ以上ルールを処理しない。関数でいうreturn/exit/break相当。これを指定しない場合、上のほうのRewriteRuleで書き換えた結果を、後続のRewriteRuleで処理することになる。基本は1 RewriteRuleにつき1L。ほぼ常につける。		* L\|last: これ以上ルールを処理しない。関数でいうreturn/exit/break相当。これを指定しない場合、上のほうのRewriteRuleで書き換えた結果を、後続のRewriteRuleで処理することになる。基本は1 RewriteRuleにつき1L。ほぼ常につける。
	* QSA\|qsappend: Query String Append。本来、書き換えする際、?%{QUERY_STRING}を自分で明示的にしない限り、クエリー文字列は破棄される。破棄せずに自動的に引き継いでくれる。リダイレクトするときに、クエリー文字列も引き継いでほしいことが多いのでよく指定する。ほぼ常につける。		* QSA\|qsappend: Query String Append。本来、書き換えする際、?%{QUERY_STRING}を自分で明示的にしない限り、クエリー文字列は破棄される。破棄せずに自動的に引き継いでくれる。リダイレクトするときに、クエリー文字列も引き継いでほしいことが多いのでよく指定する。ほぼ常につける。
	* R~~=301~~: ~~外部リダイレクト。これを指定しない場合、内部リダイレクト~~ (URLは変わらない)。		* R\|redirect: 外部リダイレクト、HTTPリダイレクトを行う。これを指定しない場合、内部リダイレクト (URLは変わらない)。R=のあとに有効なHTTPステータスコードを指定できる。302=temp (デフォルト) /301=permanent/303=seeotherのシンボリック名がある。
	* NC\|nocase: Patternのマッチの大文字小文字を無視する。		* NC\|nocase: Patternのマッチの大文字小文字を無視する。
	* B (escape backreferences): 変換前に非英数字をエスケープする。後方参照時に基本的に使う。URLのマッピング前に、URL内のエスケープを解除する。したがって、後方参照時に、エスケープが解除される。このフラグを適用すると、後方参照内の英数字以外がエスケープされる。例えば、検索フォームでx & y/zを入力すると、アドレスバーやリクエストはエスケープしてくれる。が、後方参照はエスケープを解除してしまうので、BがないとURLにx&y/zがそのまま登場して不正なURLになる。		* B (escape backreferences): 変換前に非英数字をエスケープする。後方参照時に基本的に使う。URLのマッピング前に、URL内のエスケープを解除する。したがって、後方参照時に、エスケープが解除される。このフラグを適用すると、後方参照内の英数字以外がエスケープされる。例えば、検索フォームでx & y/zを入力すると、アドレスバーやリクエストはエスケープしてくれる。が、後方参照はエスケープを解除してしまうので、BがないとURLにx&y/zがそのまま登場して不正なURLになる。

Senooken: Flags

2025-10-14T07:42:00Z

Flags

@@ 1,983行目: / 1,983行目: @@
 [https://httpd.apache.org/docs/current/ja/rewrite/ Apache mod_rewrite - Apache HTTP Server Version 2.4]
-https://grok.com/share/c2hhcmQtMw%3D%3D_73b90b17-8db9-4bb4-ad4f-3a5e18c9e238
+https://grok.com/share/c2hhcmQtMw%3D%3D_051d98f7-939d-4c82-977d-c30f506b61c7
 リダイレクトを扱うモジュール。非常によく使うので重要。
@@ 2,001行目: / 2,001行目: @@
   RewriteRule ^archives/([0-9]+)$ archives/detail.php?id=$1 [L]
   # 上記は /blog/archives/123 → /blog/archives/detail.php?id=123 になる
 ===== RewriteCond =====

Senooken: mod_rewrite

2025-10-14T06:23:52Z

mod_rewrite

差分を表示

Senooken: mod_authz_core

2025-10-14T03:34:35Z

mod_authz_core

@@ 2,059行目: / 2,059行目: @@
   Require not ip 192.168.1.1
   </RequireAll>
 ===== Basic =====

Senooken: mod_authz_core

2025-10-14T03:08:42Z

mod_authz_core

← 古い版		2025年10月14日 (火) 12:08時点における版
1,991行目:		1,991行目:

	mod_authn_core と mod_authz_core がコア機能。		mod_authn_core と mod_authz_core がコア機能。

			===== mod_authz_core =====

			* [https://httpd.apache.org/docs/2.4/mod/mod_authz_core.html mod_authz_core - Apache HTTP Server Version 2.4]
			* [https://httpd.apache.org/docs/2.4/upgrading.html Upgrading to 2.4 from 2.2 - Apache HTTP Server Version 2.4]
			* https://grok.com/share/c2hhcmQtMw%3D%3D_affdef93-e636-4f23-a274-e5f07be71b9d

			アクセス制御の指令がいくつかある。Apache 2.2まで使用されていた、Allow/Deny/Order/Satisfyがあったのだけど、2.4でこれが整理されて、別の記法が推奨になった。

			====== 対応関係 ======
			対応関係を整理する。

			昔の記法はシンプルだが、複数組み合わせた複雑な論理がしにくく、評価順序による予期せぬ動作が発生しやすかった。

			新しい記法だと、認証プロバイダー (例: ip/host/user/group/all) で定義でき、<RequreAll> (初期値)のOR、<RequireAll> のAND、<RequreNone> NOTで複雑な組み合わせが可能になり、Satisfyも不要になった。
			{\| class="wikitable"
			!シナリオ
			!古い記法 (2.2以前)
			!新しい記法 (2.4以降)
			!説明
			\|-
			\|すべて許可
			\|<code>Order allow,deny</code><code>Allow from all</code>
			\|<code>Require all granted</code>
			\|無条件でアクセスを許可。
			\|-
			\|すべて拒否
			\|<code>Order deny,allow</code><code>Deny from all</code>
			\|<code>Require all denied</code>
			\|無条件でアクセスを拒否。
			\|-
			\|特定IPからのみ許可（他拒否）
			\|<code>Order deny,allow</code><code>Deny from all</code><code>Allow from 192.168.1.1</code>
			\|<code>Require ip 192.168.1.1</code>
			\|IPアドレス（またはサブネット: <code>192.168.1</code>）を指定。部分一致可能。
			\|-
			\|特定ドメインからのみ許可（他拒否）
			\|<code>Order deny,allow</code><code>Deny from all</code><code>Allow from example.com</code>
			\|<code>Require host example.com</code>
			\|ホスト名やドメインを指定。サブドメインも対応（例: <code>.example.com</code>）。
			\|-
			\|すべて許可だが特定IPを拒否
			\|<code>Order allow,deny</code><code>Allow from all</code><code>Deny from 192.168.1.1</code>
			\|<code><RequireAll></code><code>Require all granted</code><code>Require not ip 192.168.1.1</code><code></RequireAll></code>
			\|否定には<code><RequireAll></code>を使い、AND論理で制限。複数拒否も追加可能。
			\|-
			\|認証とIP制限の両方が必要（AND）
			\|<code>Order deny,allow</code><code>Deny from all</code><code>Allow from 192.168.1.1</code><code>Satisfy all</code><code>AuthType Basic</code><code>AuthName "Secure"</code><code>AuthBasicProvider file</code><code>AuthUserFile /path/to/users</code><code>Require valid-user</code>
			\|<code>AuthType Basic</code><code>AuthName "Secure"</code><code>AuthBasicProvider file</code><code>AuthUserFile /path/to/users</code><code><RequireAll></code><code>Require valid-user</code><code>Require ip 192.168.1.1</code><code></RequireAll></code>
			\|<code>Satisfy all</code>を<code><RequireAll></code>で置き換え。認証ディレクティブは共通。
			\|-
			\|認証かIP制限のどちらかでOK（OR）
			\|<code>Order deny,allow</code><code>Deny from all</code><code>Allow from 192.168.1.1</code><code>Satisfy any</code><code>AuthType Basic</code><code>AuthName "Secure"</code><code>AuthBasicProvider file</code><code>AuthUserFile /path/to/users</code><code>Require valid-user</code>
			\|<code>AuthType Basic</code><code>AuthName "Secure"</code><code>AuthBasicProvider file</code><code>AuthUserFile /path/to/users</code><code>Require valid-user</code><code>Require ip 192.168.1.1</code>
			\|デフォルトでOR論理（<code><RequireAny></code>相当）。明示的に<code><RequireAny></code>を使ってもOK。
			\|-
			\|グループ認証とIP拒否の組み合わせ
			\|<code>Order allow,deny</code><code>Allow from all</code><code>Deny from bad.example.com</code><code>AuthType Basic</code><code>AuthName "Secure"</code><code>AuthBasicProvider file</code><code>AuthUserFile /path/to/users</code><code>AuthGroupFile /path/to/groups</code><code>Require group admin</code><code>Satisfy all</code>
			\|<code>AuthType Basic</code><code>AuthName "Secure"<nowiki><br></nowiki>AuthBasicProvider file</code><code>AuthUserFile /path/to/users</code><code>AuthGroupFile /path/to/groups</code><code><RequireAll></code><code>Require group admin</code><code>Require all granted</code><code>Require not host bad.example.com</code><code></RequireAll></code>
			\|複雑な論理はコンテナで表現。<code><RequireNone></code>で複数のNOTも可能（例: <code><RequireNone> Require host bad1 Require host bad2 </RequireNone></code>）。
			\|}
			デフォルトがORなので、<RequireAll>でAND条件にするのが基本。

			特定IP/hostのみ除外はよく使うと思われる。
			<RequireAll>
			Require all granted
			Require not ip 192.168.1.1
			</RequireAll>

	===== Basic =====		===== Basic =====

Senooken: auth Basic

2025-10-14T02:34:53Z

auth Basic

← 古い版		2025年10月14日 (火) 11:34時点における版
1,984行目:		1,984行目:

	リダイレクトを扱うモジュール。非常によく使うので重要。		リダイレクトを扱うモジュール。非常によく使うので重要。

			==== auth ====
			[https://httpd.apache.org/docs/2.4/ja/howto/auth.html 認証、承認、アクセス制御 - Apache HTTP サーババージョン 2.4]

			Apache HTTP Serverで実現可能な認証機能が複数ある。

			mod_authn_core と mod_authz_core がコア機能。

			===== Basic =====
			一番基本的な認証機能では、<Directory>指令か、.htaccessで定義する。

			以下の流れで認証設定する。

			# htpasswdでパスワードを作成
			# <Directive>/.htaccessで保護対象パスを指定。
			# 認証方式とパスワードファイルの指定

			====== htpasswd ======
			[https://httpd.apache.org/docs/2.4/ja/programs/htpasswd.html htpasswd - Manage user files for basic authentication - Apache HTTP Server Version 2.4]

			最初にパスワードファイルを作成する。認証プロバイダーによって作成方法が異なる。

			Basic認証では、htpasswdコマンドで作る。httpd付属のパスワード作成ソフト。
			htpasswd [option] <passwordfile> <username>

			* 引数
			** <passwordfile>: 作成するパスワードファイルのパス。
			** <username>: パスワードのユーザー名。

			* オプション
			** -c: create。パスワードファイルを新規作成する。上書きするので初回だけ実行すること。

			例:
			htpasswd -c /usr/local/apache/passwd/passwords rbowen
			htpasswdを実行するとパスワードの入力が要請されるので、入力する。

			ログイン前に確認されないように、パスワードファイルは、Webからアクセス不能な場所 (documentroot外部) に配置する。

			====== .htaccess ======
			パスワードファイルを作成したら、設定で参照する。

			httpd.confの<Directory> セクションか、.htaccessで以下の内容を記載する。
			AuthType Basic
			AuthName "Restricted Files"
			# (Following line optional)
			AuthBasicProvider file
			AuthUserFile /usr/local/apache/passwd/passwords
			Require user rbowen
			指令の内容は以下の通り。

			* AuthType: 認証方式。一般的なのはBasic。パスワードを暗号化せずにクライアントに送信するので、HTTPS必須。
			* AuthName: 認証に使うRealm (領域) を指定。2種類の役割がある。1. パスワード入力ダイアログに表示する情報の一部としてWebブラウザーが使う。2. 認証領域の流用で使う。同じRealmの指定があれば、クライアントに保存された同じパスワードをWebブラウザーが自動入力しようとする。
			* AuthBasicProvider: 認証プロバイダーの指定。初期値fileなのでAuthType Basicの場合省略可能尾。mod_authn_dbm/mod_authn_dbdなどDBを使う場合指定必須。
			* AuthUserFile: htpasswdで作成したパスワードファイルのパスを指定。リクエストのたびにこのプレーンテキストを検査する。ユーザー数が数百を超えると遅延を感じる。その場合、mod_authn_dbmのAuthDBMUserFileでDBファイルを指定したりする。
			* Require: アクセス可能なユーザーを指定する。

			Requireはいくつか指定方法がある。ユーザーを指定する方式だと、複数ユーザーを追加する場合、都度修正が必要になる。

			グループの指定か、valid-userで複数ユーザーを管理できる。

			AuthGroupFileで以下のようなユーザー名を列挙したグループを定義する。
			GroupName: rbowen dpitts sungo rshersey
			続いて、htpasswdに上記のユーザーを追加する。
			htpasswd /usr/local/apache/passwd/passwords dpitts
			最後に、Require group GroupNameでグループを指定する。
			AuthType Basic
			AuthName "By Invitation Only"
			# Optional line:
			AuthBasicProvider file
			AuthUserFile /usr/local/apache/passwd/passwords
			AuthGroupFile /usr/local/apache/passwd/groups
			Require group GroupName
			これで複数ユーザーをグループファイルに外だしできる。

			他に、Require valid-userを指定すると、パスワードファイル記載のどのユーザーでも承認する。

			パスワードファイルがグループも兼ねるイメージ。ユーザーが少ないなら、Require valid-userがシンプル。

	===E-mail===		===E-mail===

Senooken: Using $ref Example

2025-10-07T05:38:16Z

Using $ref Example

@@ 628行目: / 628行目: @@
 定義と参照を上記のように行う。
-$refはJSON Reference気泡になっている。先頭の#はファイル内参照を意味する。
+$refはJSON Reference (JSON pointer) 記法になっている。#以降はファイル内参照を意味する。先頭の#で現在のファイル。
 $ref: 'document.json#/myElement' のように記載することで、別のファイル内のコンポーネントを参照できる。
 ===== Grouping Operations With Tags =====

Senooken: /* レスポンス設計 */

2025-10-07T02:24:05Z

レスポンス設計

← 古い版		2025年10月7日 (火) 11:24時点における版
424行目:		424行目:
	}		}
	トップレベル要素を配置することで、クライアントはこのプロパティーの有無で成否を判断できて処理が楽になるとか。まあ、そうか。		トップレベル要素を配置することで、クライアントはこのプロパティーの有無で成否を判断できて処理が楽になるとか。まあ、そうか。

			MVCだと、Modelがビジネスロジックで、エラーコードを定義することが多いので、ここでmapとかstaticメソッドを作ってやるとよさそう。

	=== Swagger ===		=== Swagger ===