Ground Sunlight

Windowsで作る - PHPプログラミングの開発環境

ユーザ用ツール

サイト用ツール


composer:1.9:version-constraints

差分

このページの2つのバージョン間の差分を表示します。

この比較画面にリンクする

両方とも前のリビジョン 前のリビジョン
次のリビジョン
前のリビジョン
composer:1.9:version-constraints [2020/03/16 21:40]
y2sunlight [最小安定値]
composer:1.9:version-constraints [2020/07/08 09:51] (現在)
tanaka [キャレットによるバージョン範囲の指定 (^)]
行 11: 行 11:
   * [[composer:1.9:install|Composerのインストール]]   * [[composer:1.9:install|Composerのインストール]]
   * [[composer:1.9:phpswitch|ComposerをPHPバージョンで使い分ける]]   * [[composer:1.9:phpswitch|ComposerをPHPバージョンで使い分ける]]
 +  * [[composer:1.10:local-install|Composerのローカルインストール]]
   * [[composer:1.9:basic-usage|Composer 基本的な使い方]]   * [[composer:1.9:basic-usage|Composer 基本的な使い方]]
   * [[composer:1.9:command-list|Composer コマンド一覧]]   * [[composer:1.9:command-list|Composer コマンド一覧]]
行 29: 行 30:
 \\ \\
  
-===== VCS Tags and Branches =====+===== VCSのタグとブランチ =====
  
 以下の説明では、次のサンプルライブラリのリポジトリを想定します。 以下の説明では、次のサンプルライブラリのリポジトリを想定します。
行 56: 行 57:
 </code> </code>
  
-==== Tags ====+==== タグ ====
  
 通常、Composerはタグを処理します。バージョン制約を記述するとき、特定のタグ(例:''1.1'')を参照する場合と、有効なタグ範囲(例:''>= 1.1 <2.0'' または ''~4.0'')を参照する場合があります。これらの制約を解決するために、ComposerはまずVCSに利用可能な全てのタグを一覧表示するように要求し、次にこれらのタグに基づいて利用可能なバージョンの内部リストを作成します。上記の例では、composerの内部リストには、バージョン''1.0''、''1.0.1''、''1.0.2''、''1.1-BETA''、''1.1''のRC1版とRC2版、''1.1''の最終リリース版などが含まれています。(Composer有効な最終バージョン番号を取得するために、実際のタグ名の ''v''プレフィックスを自動的に削除します。 通常、Composerはタグを処理します。バージョン制約を記述するとき、特定のタグ(例:''1.1'')を参照する場合と、有効なタグ範囲(例:''>= 1.1 <2.0'' または ''~4.0'')を参照する場合があります。これらの制約を解決するために、ComposerはまずVCSに利用可能な全てのタグを一覧表示するように要求し、次にこれらのタグに基づいて利用可能なバージョンの内部リストを作成します。上記の例では、composerの内部リストには、バージョン''1.0''、''1.0.1''、''1.0.2''、''1.1-BETA''、''1.1''のRC1版とRC2版、''1.1''の最終リリース版などが含まれています。(Composer有効な最終バージョン番号を取得するために、実際のタグ名の ''v''プレフィックスを自動的に削除します。
行 63: 行 64:
  
  
-==== Branches ====+==== ブランチ ====
 Composerにタグの代わりにブランチをチェックアウトさせる場合は、特別な ''dev-*'' プレフィックス(または サフィックス。以下を参照)を使用してブランチを指示する必要があります。ブランチをチェックアウトしている場合、ブランチで作業することを想定しているため、Composerは実際にリポジトリを''vender'' ディレクトリの正しい場所に複製します。タグの場合は、実際にリポジトリを複製せずに適切なファイルをコピーします。(この動作は ''--prefer-source'' および ''--prefer-dist'' で変更できます。''install'' コマンドの[[https://getcomposer.org/doc/03-cli.md#install-i|オプション]]を参照してください。) Composerにタグの代わりにブランチをチェックアウトさせる場合は、特別な ''dev-*'' プレフィックス(または サフィックス。以下を参照)を使用してブランチを指示する必要があります。ブランチをチェックアウトしている場合、ブランチで作業することを想定しているため、Composerは実際にリポジトリを''vender'' ディレクトリの正しい場所に複製します。タグの場合は、実際にリポジトリを複製せずに適切なファイルをコピーします。(この動作は ''--prefer-source'' および ''--prefer-dist'' で変更できます。''install'' コマンドの[[https://getcomposer.org/doc/03-cli.md#install-i|オプション]]を参照してください。)
  
行 72: 行 73:
 ==== 最小安定値 ==== ==== 最小安定値 ====
 ライブラリのVCSからチェックアウトされ、プロジェクトに追加されるファイルに影響するもう1つのことがあります。それは、Composerでは「安定性の制約」を指定して有効と見なされるタグを制限できるという事です。 上記の例では、ライブラリが最終的な公式リリースの前にβ版と、バージョン1.1の2つのリリース候補版(RC1とRC2)をリリースしたことに注意してください。Composerの ''install'' または ''update'' の実行時にこれらのバージョンを受け取るには、リリース候補とβリリース(および必要に応じてαリリース)で問題ないことをComposerに明示的に通知する必要があります。これは、''composer.json'' でプロジェクト全体の「最小安定値」を使用するか、バージョン制約で「安定フラグ」を使用して実行できます。 詳細については、[[https://getcomposer.org/doc/04-schema.md#minimum-stability|スキーマページ]]をご覧ください。 ライブラリのVCSからチェックアウトされ、プロジェクトに追加されるファイルに影響するもう1つのことがあります。それは、Composerでは「安定性の制約」を指定して有効と見なされるタグを制限できるという事です。 上記の例では、ライブラリが最終的な公式リリースの前にβ版と、バージョン1.1の2つのリリース候補版(RC1とRC2)をリリースしたことに注意してください。Composerの ''install'' または ''update'' の実行時にこれらのバージョンを受け取るには、リリース候補とβリリース(および必要に応じてαリリース)で問題ないことをComposerに明示的に通知する必要があります。これは、''composer.json'' でプロジェクト全体の「最小安定値」を使用するか、バージョン制約で「安定フラグ」を使用して実行できます。 詳細については、[[https://getcomposer.org/doc/04-schema.md#minimum-stability|スキーマページ]]をご覧ください。
 +
 +\\
  
 ===== バージョン制約の書き方 ===== ===== バージョン制約の書き方 =====
行 134: 行 137:
  ^演算子は、セマンティックバージョニングに近いものであり非常によく似た動作をしますが、常に非破壊的な更新を許可します。例えば、''^1.2.3'' は、''>=1.2.3 <2.0.0'' と同等です。これは、''2.0'' が下位互換性を破るまでリリースがないためです。''1.0'' より前のバージョンでは、安全性を考慮して機能し、''^0.3'' を ''>=0.3.0 <0.4.0'' として扱います。  ^演算子は、セマンティックバージョニングに近いものであり非常によく似た動作をしますが、常に非破壊的な更新を許可します。例えば、''^1.2.3'' は、''>=1.2.3 <2.0.0'' と同等です。これは、''2.0'' が下位互換性を破るまでリリースがないためです。''1.0'' より前のバージョンでは、安全性を考慮して機能し、''^0.3'' を ''>=0.3.0 <0.4.0'' として扱います。
  
-この演算子(^)、ライブラリコードを記述するときに相互運用性を最大限に高めるための推奨演算子です。+この演算子(^)、ライブラリコードを記述するときに相互運用性を最大限に高めるための推奨演算子です。
  
 例: ^1.2.3 例: ^1.2.3
  
-===== Stability Constraints =====+\\ 
 + 
 +===== 安定性の制約 =====
 安定性を明示的に定義しない制約を使用している場合、Composerは内部的に ''-dev'' または ''-stable'' をデフォルトで使用します。これは使用する演算子によって異なります。そして、これは透過的に発生します。 安定性を明示的に定義しない制約を使用している場合、Composerは内部的に ''-dev'' または ''-stable'' をデフォルトで使用します。これは使用する演算子によって異なります。そして、これは透過的に発生します。
  
行 163: 行 168:
  
 === 正確なバージョンを指定 === === 正確なバージョンを指定 ===
-<code json>+<code javascript>
 "require": { "require": {
  
行 171: 行 176:
  
 === 上下限を指定 === === 上下限を指定 ===
-<code json>+<code javascript>
 "require": { "require": {
  
行 181: 行 186:
  
 === ワイルドカード === === ワイルドカード ===
-<code json>+<code javascript>
 "require": { "require": {
  
行 190: 行 195:
  
 === 指定された最後の数字が上がることを許可 === === 指定された最後の数字が上がることを許可 ===
-<code json>+<code javascript>
 "require": { "require": {
  
行 200: 行 205:
  
 === 破壊的更新を許さない(メジャーバージョンの固定) === === 破壊的更新を許さない(メジャーバージョンの固定) ===
-<code json>+<code javascript>
 "require": { "require": {
  
行 215: 行 220:
 [[https://semver.mwl.be/|semver.mwl.be]]を使用してバージョンの制約をテストできます。パッケージ名を入力すると、Composerが''composer.json'' ファイルに追加するデフォルトのバージョン制約が自動入力されます。バージョン制約を調整すると、ツールは一致するすべてのリリースを強調表示します。 [[https://semver.mwl.be/|semver.mwl.be]]を使用してバージョンの制約をテストできます。パッケージ名を入力すると、Composerが''composer.json'' ファイルに追加するデフォルトのバージョン制約が自動入力されます。バージョン制約を調整すると、ツールは一致するすべてのリリースを強調表示します。
  
 +\\
composer/1.9/version-constraints.1584362459.txt.gz · 最終更新: 2020/03/16 21:40 by y2sunlight