Copyright

プロジェクトには、コピーライトで保護したいファイルが含まれている場合があります。各ファイルに個別にコピーライト表示を追加する代わりに、著作権プロファイルを使用できます。

プロファイルは、コピーライト表示テキストと、このテキストが組み込まれる一連のファイル（スコープ）を定義します。

同じプロジェクト内のファイルには、いくつかの異なるコピーライト表示が必要な場合があります。この場合、複数のプロファイルを設定し、異なるスコープに関連付けることができます。

コピーライトプロファイルを構成する

PhpStorm では、コピーライトプロファイルをローカルに保存したり共有したりできます。

共有プロファイルは .xml ファイル内の .idea/copyright に保存され、VCS を通じてチームの他のメンバーが利用できるようになります。

ローカルコピーライトプロファイルは IDE レベルで保存され、現在の IDE インスタンスで開いたすべてのプロジェクトで使用できます。

新しいコピーライトプロファイルを作成する

プロファイルを使用すると、後でプロジェクト全体に挿入したり、特定のファイルにのみ追加したりできるコピーライトテキストを定義できます。

Ctrl+Alt+S を押して設定を開き、エディター | コピーライト | コピーライトプロファイルを選択します。
新しく作成されたすべてのプロジェクトのデフォルトプロファイルを構成するには、ファイル | 新規プロジェクトのセットアップ | 新規プロジェクトの設定を選択し、エディター | コピーライト | コピーライトプロファイルに移動します。
をクリックし、新しいプロファイルに名前を付けます。
VCS で共有するを選択してこのプロファイルを .idea フォルダーに配置し、チームと共有するか、チェックボックスをオフにしてこのプロファイルをローカルに保持し、すべてのプロジェクトで使用できるようにします。
コピーライト表示のテキストを入力します。
プレーンテキストを入力するか、Velocity テンプレートを構成することができます。テンプレートの場合は、変数を使用し、 Validate をクリックして、正しく構成されていることを確認します。

プロファイルが設定されると、テキストを追加するファイルの範囲を選択したり、どの範囲にも含まれていないプロジェクト内のすべてのファイルのデフォルトプロファイルとしてこのプロファイルを設定したりできます。

コピーライト変数

現在、Velocity コンテキストでは次の変数が使用できます。

Name	Type	Comment
`$today`	`DateInfo`	現在の日付と時刻。 `DateInfo` プロパティと一緒に使用します。たとえば、 `$today.year` は現在の年を挿入します。
`$file.fileName`	`String`	生成される現在開いているファイルの名前。
`$file.pathName`	`String`	生成される現在開いているファイルの完全なパスと名前。
`$file.className`	`String`	Java および Groovy ファイルでは、クラスの名前です。その他のファイルでは、ファイル名で、 `$file.fileName` と同じです。
`$file.qualifiedClassName`	`String`	Java および Groovy ファイルでは、クラスの完全修飾名です。その他のファイルでは、ファイルの完全なパスと名前で、 `$file.pathName` と同じです。
`$file.lastModified`	`DateInfo`	現在のファイルが最後に変更された日時。 `DateInfo` プロパティと一緒に使用します。たとえば、 `$file.lastModified.year` です。
`$project.name`	`String`	現在のプロジェクトの名前。
`$username`	`String`	現在のオペレーティングシステムユーザーのログイン名です。
`$originalComment.match(regexp, group, suffix, ignoreValue)`	`String`	`regexp` が既存のコピーライト通知の `グループ` グループでキャプチャするテキストで、その後に `suffix` が続きます。通知を更新するときに元の年を保持するために使用します。既存の通知がない場合、 `regexp` が通知に一致しない場合、またはキャプチャされたテキストが `ignoreValue` と等しい場合は、空の文字列を返します。 `ignoreValue` は省略できます。 `regexp` のみを渡すと、 `グループ` は `1` になり、サフィックスは追加されません。

$today と $file.lastModified には、次のプロパティとメソッドがあります。表では、 $today を付けて表示しています。最終変更日には、 $file.lastModified を付けた同じ名前を使用します。例: $file.lastModified.year。

Name	Type	Comment
`$today.year`	`int`	年です。たとえば、 `2026` です。
`$today.month`	`int`	月 (1-12) です。
`$today.day`	`int`	月内の日 (1-31) です。
`$today.hour`	`int`	12 時間形式の時 (0-11) です。
`$today.hour24`	`int`	24 時間形式の時 (0-23) です。
`$today.minute`	`int`	時の分 (0-59) です。
`$today.second`	`int`	分の秒 (0-59) です。
`$today.format(String format)`	`String`	日付と時刻のパターンでフォーマットされた日付と時刻です。たとえば、 `$today.format("yyyy-MM-dd")` は `2026-10-01` を返します。

コピーライトテンプレートの日付

デフォルトでは、コピーライトテンプレートには 2 つの年 (元の年と現在の年) が含まれます。

新しいコピーライト表示を挿入すると、元の年は現在の年と一致するため、1 年だけが追加されます (たとえば、 2021)。翌年、コピーライトを更新するときに通知を再生成できるようになり、元の年が現在の年 (2021 – 2022) と並んで表示されます。こうすることで、コピーライトを更新するたびに年を手動で追加する必要がなくなります。

テンプレートでは、元の年は $originalComment.match("Copyright $c$ (\d+)", 1, "-") コードで取得され、現在の年は $today.year コードで挿入されます。詳しくは GitHub のソースコード(英語)を参照してください。

新しいコピーライトの形式がテンプレート内の以前のコピーライトの形式と一致する場合、年は正しく更新されることに注意してください。ファイルから年を取得するテンプレートの部分を、元のコピーライトの形式と一致するように編集してください。

ファイルのスコープにプロファイルを割り当てる

構成されたコピーライトテキストを追加するファイルのスコープを選択します。

Ctrl+Alt+S を押して設定を開き、エディター | コピーライトを選択します。
をクリックして（または Alt+Insert を押して）、リストから既存の共有スコープを選択します。
必要に応じて新しいスコープを定義することができます。ページの下部にあるスコープを追加または既存のスコープを変更するには、スコープを選択しますリンクをクリックします。
Copyright リストから、スコープにリンクするプロファイルを選択します。
変更を適用し、ダイアログを閉じます。

その後、必要なファイルにコピーライトを追加できます。

デフォルトのコピーライトプロファイルを設定する

既定のプロファイルの設定は、プロファイルでカバーされているすべてのスコープに明示的に含まれていないファイルに適用されます。

Ctrl+Alt+S を押して設定を開き、エディター | コピーライトを選択します。
デフォルトのプロジェクトコピーライトリストから、デフォルトプロファイルとして使用するプロファイルを選択します。
変更を適用し、ダイアログを閉じます。
その後、必要なファイルにコピーライトを追加できます。

コピーライトテキスト形式を構成する

デフォルトでは、IDE は各行に接頭辞を付けて他のコメントの前にブロックコメントを貼り付け、ブロックの後に空白行を追加します。

すべてのファイルまたはファイルタイプごとに個別にデフォルトの形式を変更できます。

Ctrl+Alt+S を押して設定を開き、エディター | コピーライト | フォーマットを選択します。
このページでは、すべてのタイプのファイルのフォーマットを構成できます。
特定のファイルタイプのフォーマットを変更するには、整形ノードでそのフォーマットを選択します。
フォーマットオプションを設定します。プレビューセクションを使用して、新しいフォーマットが意図したとおりに表示されていることを確認します。

コピーライトプロファイルをインポートする

別のプロジェクトでプロファイルを使用する場合は、プロファイル設定を含む .xml ファイルを別の場所にコピーしてインポートします。

Ctrl+Alt+S を押して設定を開き、エディター | コピーライト | コピーライトプロファイルを選択します。
をクリックし、開いたダイアログで、使用するプロファイルを含む .xml ファイルを選択します。
必要に応じてプロファイルの名前を変更し、 OK をクリックします。
設定が正常にインポートされると、確認のポップアップが表示されます。

コピーライトテキストをファイルに挿入する

単一のファイルにテキストを挿入するには、エディターでファイルを開き、 Alt+Insert を押して、ポップアップから Copyright を選択します。
ファイルのグループにテキストを挿入するには、 Project ツールウィンドウでノードを右クリックし、コピーライトの更新を選択します。通知を更新するスコープを選択するように求められます。
ノードには、異なるスコープに属するファイルが含まれている場合があります。この場合、割り当てられたプロファイルに従ってコピーライト表示が生成されます。
どのスコープにも属していないファイルがノードに含まれている場合、IDE はそのノードにデフォルトプロファイルを割り当てます。

コピーライト表示の更新

コピーライトテキストを更新

Ctrl+Alt+S を押して設定を開き、エディター | コピーライト | コピーライトプロファイルを選択します。
必要なプロファイルを選択し、コピーライトテキストを編集します。
コメント内のコピーライトを検出する正規表現フィールドに、ファイル内の既存のコピーライト情報を検索するために使用される正規表現を指定します。
IDE はこの表現を使用して、他のコメントの中からコピーライトに関するコメントを識別します。例: そのようなコメントは通常 Copyright という単語を含みます。
古いコピーライトと一致する場合はコピーライトの置き換えを許可するフィールドで:
必要に応じて、PhpStorm が更新する既存のコピーライト通知を制限する正規表現を指定します。 PhpStorm は、検出された通知のテキストの一部にこの式が一致する場合にのみ、その通知を置換します。式では大文字と小文字が区別されます。フィールドを空のままにすると、PhpStorm は検出されたすべての通知を置換します。
たとえば、自社の通知を更新し、サードパーティコード内の通知は変更しないようにするには、会社名を指定します: Acme Corp。
変更を適用し、ダイアログを閉じます。
Project （Alt+1 ）ツールウィンドウで、テキストを更新するノードを右クリックし、コピーライトの更新を選択します。

保存時にコピーライトを更新する

IDE が変更を保存するたびにコピーライト表示を更新するように IDE を構成できます。

Ctrl+Alt+S を押して設定を開き、ツール | 保存時のアクションを選択します。
コピーライト表示の更新のチェックボックスを選択します。
このチェックボックスは、少なくとも 1 つのコピーライトプロファイルを構成し、このプロファイルが適用されるファイルのスコープを指定した場合に使用できます。
プロファイルをまだ構成していない場合は、構成… リンクをクリックします。
プロファイルが構成されたら、ツール | 保存時のアクションに戻り、コピーライト表示の更新チェックボックスを有効にします。
変更を適用し、ダイアログを閉じます。

保存時に有効にできるアクションの詳細については、「変更を保存するときにアクションをトリガーする」を参照してください。

2026 年 11 月 9 日