Lerd: LinuxおよびmacOS向けのオープンソースのHerdライクなPHP開発環境
Lerd, an open source Herd-like PHP development environment for Linux and macOS (github.com)
要約
Lerdは、LinuxおよびmacOS(WSL2経由でWindowsもサポート)向けの、PodmanネイティブでrootlessなPHP開発環境です。Dockerやsudoを使わず、システムを汚染しない設計で、プロジェクトごとに異なるPHPバージョンやHTTPS、自動的な.testドメイン設定などを簡単に実現できます。Web UIやターミナルUIを備え、Laravel、Symfony、WordPressなど主要なPHPフレームワークに対応しています。
全文翻訳
LinuxおよびmacOS向けのオープンソースローカルPHP開発環境。WindowsはWSL2(ベータ版)経由でサポートされます。Podmanネイティブ、rootlessで、Web UIを内蔵しています。
[画像: CI] [画像: Release] [画像: License: MIT] [画像: Platform] [画像: Docs] [画像: Reddit] [画像: Discord]
Sponsored by
lerd-spot-readme.mp4[[動画]]
Lerdは、Nginx、PHP-FPM、およびサービスをrootless Podmanコンテナとして実行します。LinuxおよびmacOSのPHP開発者向けに設計されており、WSL2(ベータ版)を介してWindowsでも利用できます。Docker不要、sudo不要、システムを汚染しません。lerd linkを実行するだけで、プロジェクトがHTTPSでproject.testで利用可能になります。
LinuxおよびmacOSのPHP開発者のために構築
Lerdは、Linuxデスクトップ、Mac、またはWSL2(ベータ版)を介したWindowsで、摩擦のないローカル開発を求めるPHP開発者のために構築されています。自動.testドメイン、プロジェクトごとのPHPバージョン、ワンクリックHTTPS、Docker不要です。Laravel、Symfony、WordPress、Drupal、Magento、CakePHP、Statamic、Yii、およびカスタムPHPフレームワークと連携します。
特徴
サイト、ドメイン、TLS
-
🌐 自動
.testドメイン。 1つのコマンドでプロジェクトにホスト名とTLSが提供され、期限切れ前に再発行されます。dnsmasqやシステムリゾルバの調整、DNS関連のsudoは不要です。*.localhostのlerd管理DNSをオプトアウトしたり、後でdns:enable/dns:disable/dns:repairで切り替えたりできます。 -
🔗 サイトグループ。 関連するサイトをグループ化し、メインサイトがベースドメインを所有し、残りがサブドメインを占めるようにします。セカンダリごとに共有または個別のデータベースを使用できます。
-
🧱 Node、Python、Railsなど。
lerd initは、Node、Python、RailsまたはRack、GoまたはRustプロジェクトを認識し、ホスト上でlerdの監視下で開発サーバーを実行し、HTTPSで.testドメインで提供します。サービスとワークツリーも含まれます。または、スターターContainerfile.lerdからrootlessコンテナとして提供します。 -
🌳 ファーストクラスのgitワークツリー。 自動検出されるブランチドメイン、ワークツリーごとのPHPおよびNodeバージョン、スクリプトが追加した際にブランチのマイグレーションから選択されるデータベース、ワイルドカード証明書のSAN、ブランチごとのViteワーカー。任意のツールからのベアな
git worktree addが自動的にプロビジョニングされ、サイトヘッダーはブランチの取得、プル、プッシュ、切り替えを行い、データベースをスナップショットしてから必要なインストールとマイグレーションを提供します。 -
🌍 サイトを共有。 LAN上で安定したポートとQRコードを使用するか、ngrok、cloudflared、Expose、Pinggy、serveo、またはlocalhost.runを介して公開します。ベースドメインを一度設定すると、トンネルサービスまたは実行中のリバースプロキシを通じて、すべての共有で実行間で同じURLが維持されます。
-
🎨 サイト固有のドメインでの開発サーバー。 実行中のViteは、
localhost:5173をアドバタイズする代わりに、サイトの.testホスト名の下でアセットとホットリロードソケットを提供します。これにより、共有、LAN経由で開かれた、またはワークツリーのページがスタイル付きで表示されます。プロジェクト内の何も編集されず、フレームワークごとに何も宣言されません。
PHP、Node、ランタイム
-
🐘 プロジェクトごとのPHPバージョン。 8.1から8.5まで、凍結された7.4 / 8.0レガシーティア、およびプレリリース版の8.6。ワンクリックで切り替え可能です。カスタム拡張機能とAlpineパッケージは、lerdがビルドするすべてのイメージに対して一度宣言され、ODBCスタックはすべてに同梱されています。
-
⚡ ホスト上のPHP(macOS)。 ネイティブランタイムはPHP-FPM、CLI、Composer、ワーカーをホスト上で実行し、MacがPHPの読み取りファイルごとに支払うバインドマウントの境界を削除します。Laravelアプリ(HorizonとFilamentを含む)は、毎秒62リクエストから238リクエストに向上しました。コンテナはデフォルトのままです。
-
⚡ FrankenPHPランタイム。 共有PHP-FPMの代替としてサイトごとに、Laravel OctaneおよびSymfony Runtimeワーカーモードをサポートします。
-
📱 NativePHP、デスクトップおよびモバイル。 Electronアプリはホストワーカーとして実行され、モバイルビルドはエミュレータ、シミュレータ、またはデバイスに到達します。コンテナ内に存在できないランタイムを持つコマンドは、PHPコンテナで失敗する代わりにホスト専用として宣言されるため、
native:runはそのウィンドウを開きます。 -
📦 Node.js分離。 プロジェクトごとにNode 22または24。
.nvmrc、.node-version、mise.toml、または.tool-versionsから読み取られ、mise(新規インストール時のデフォルト)、fnm、または既存のnvmを介して、ダッシュボードから切り替え可能です。または、ホスト上のJSランタイムとしてbun、およびオプションでコンテナ内でも使用できます。 -
🪄 フレームワークごとのセットアップ不要。 ワーカー、環境値、nginx vhostは、プロジェクトをリンクする際に設定されます。「環境」とは、フレームワークが読み取るファイル(
.env、wp-config.php、Magentoのenv.php、Drupalのsettings.php)を指し、その場に書き込まれます。選択したワーカーオプションは.lerd.yamlにコミットされます。 -
🧩 フレームワークストア。 Laravel、Lumen、Symfony、WordPress、Bedrock、Drupal、Magento、CakePHP、CodeIgniter、Statamic、Winter CMS、Tempest、TYPO3、Yii。メジャーバージョンごとに検出されます。Composerパッケージは、独自のワーカーと必要なサービスを宣言し、新しい定義はlerdのリリースなしで追加されます。
サービスとデータベース
-
🗄️ ワンクリックサービス。 MySQL、PostgreSQL、Redis、Meilisearch、RustFS、Mailpit、OpenSearch、Solr、Kafka、LocalStackなど、更新可能なストアから利用できます。管理ダッシュボードはログイン済みの状態で開き、サービスページはMailpit用のSpamAssassinのように、それに合わせて機能するものを提案します。
-
🔌 コンテナに到達するホストツール。
psql、mysql、pg_dumpなどは、クライアントをインストールせずにホスト上でlerdのエンジンに対して実行されます。IDEのphpstan、php-cs-fixer、phpcsは、プロジェクトのPHPコンテナ内の同じシムを介して実行され、lerd cpxはComposerパッケージの任意のコマンドを実行します。 -
🧷 JetBrains向けIDEデータベース接続。 プロジェクトは、実際に応答しているホストポート上のlerdデータベースを指す1つのデータソースを取得します。これはリンク時に書き込まれ、プロジェクトのデータベースが変更されると更新されます。lerdが所有していないデータソースはそのまま残ります。
デバッグとパフォーマンス
-
🛰️ デバッグウィンドウ。 すべての
dump()/dd()、N+1のSQL、スロークエリ検出、メール、ビュー、イベント、ジョブ、HTTPリクエストが、サイトとブランチごとにダッシュボード、TUI、MCP、lerd dump tailで表示されます。ray()、アプリログ、SentryまたはInspectorの例外、送信SMSおよびSlackメッセージ、ブラウザでサイトページがヒットするエラーもここに表示され、最近のリクエストはすべて実行されたもののタイムラインで開かれます。 -
🔥 SPXプロファイラーをワンクリックでオン/オフできます。すべてのPHP-FPMリクエストは、FPMの再起動やコード変更なしで、ダッシュボードの同じオリジンのProfilerビューで表示可能なフレアグラフになります。
lerd profile runは、ワンショットのArtisanまたはCLIコマンドをプロファイルします。 -
📈 リクエストタイミング分析。 サイトごとの耐久性のあるビューで、通常の応答時間とp95応答時間、スループット、エラー率、および最近のp95でランク付けされた最も遅いルートをワンクリックプロファイリングで表示します。エージェントはMCPを介して
route_timingとoptimize_routeで同じ信号を取得します。 -
🧪 Tinkerタブ。 プロジェクト固有のオートコンプリート、ホバー、診断機能を備えたブラウザ内PHP REPL。これはphpantom_lspによって強化されており、モデルとBuilderチェーンが入力中に解決されます。Laravel、Symfony、および任意のComposerプロジェクトで動作します。
インターフェース
-
🖥️ 組み込みWeb UI。 サイトとサービスのダッシュボード、ライブウィジェット、Cmd+Kパレット。14言語と12テーマに対応し、Omarchy、Plasma、GNOME、macOSのデスクトップカラーも取り込み、すべての埋め込み管理ダッシュボードに適用されます。スクリーンリーダーフレンドリーで、ストリーミングモードを備えています。
-
✨ ダッシュボードからプロジェクトを開始。 サイトの「+」ボタンから、フレームワークストアからプロジェクトをスキャフォールドしたり、既存のプロジェクトをリンクしたりできます。
lerd initと同じ質問をし、ComposerとJSビルドをモーダルで実行します。インストールの途中でタブを閉じても、再開されます。 -
📚 ドキュメント、オフライン。 すべてのページがバイナリ内に同梱されており、検索可能でダッシュボードでレンダリングされるため、インターネットがないマシンでドキュメントが必要なときに機能しなくなったりしません。
lerd manはターミナルで同じページを読み取ります。 -
💻 ターミナルダッシュボード (
lerd tui)。サイドバーとCtrl+Pパレットがあり、すべてのページ、サイト、サービス、アクションに到達できます。ターミナルの色で描画され、ライブステータス、ワークツリータブ、シェルドロップイン、ログテアリング、スナップショット付きデータベース、各サービスのツールとチューニングを備えています。tmuxとSSHに対応しています。 -
🚀 ターミナルなしで起動。 ダッシュボードは、バナーからlerdを起動し、ユニットごとにストリーミングします。
lerd installは、macOSのアプリケーションフォルダとLinuxのアプリリストにLerdを追加し、クロムレスアプリウィンドウとして開くため、コールドスタートはクリック1つです。トレイはオプションです。 -
🧩 PhpStormプラグイン。 Lerd for PhpStormは、開いているプロジェクトをサイトに解決し、ログ、PHPバージョン、ワーカー、サービス、クエリ結果、ダンプをIDEに表示します。スタックトレース内のパスは、例外が発生した行からクリック1つでアクセスできます。
-
🪟 Omarchyバーウィジェット。 lerd Glanceは、サイト、サービス、ワーカー、コンテナのCPUとメモリをOmarchy Quattroバーに配置します。問題が発生するまで静かで、タブを開かずに環境の状態を確認できます。
-
✏️ ブラウザで設定を編集。 サイトごとおよびグローバルなNginx(サーバーおよびロケーションスコープ)、PHPバージョン固有のファイルと共有ファイルの両方を持つ
php.ini、.envファイル、およびサービスランタイムチューニング。それぞれが検証され(該当する場合はnginx -t)、タイムスタンプ付きバックアップとワンクリック復元が可能です。 -
📋 ライブログ PHP-FPM、Queue、Schedule、Reverb用。サイトごとに、ツールが実際にエミットする色(artisan、composer、vite、pest)でレンダリングされ、ボタンで任意のログを実際のターミナルに渡せるため、タブを閉じても長いログテイルが保持されます。
-
🔔 中断する価値のある通知。 開いているダッシュボード、Web Push経由で購読しているブラウザ、またはデスクトップのネイティブ通知デーモンに配信されます。すべてがダッシュボードのサイドバーベルにも着信し、リロード間で未読数を保持した最後の50件を記録します。
-
🤖 MCPサーバー。 AIアシスタント(Claude Code、Cursor、JetBrains Junie、Codex CLI、Gemini CLI、GitHub Copilot、Google Antigravity、Windsurf、OpenCode)に開発環境を直接管理させます。ワンコマンドまたはダッシュボードのスイッチで登録できます。
AI統合(MCP)
Lerdには、組み込みのModel Context Protocolサーバーが付属しています。Claude Code、Cursor、JetBrains Junie、Codex CLI、Gemini CLI、GitHub Copilot、Google Antigravity、Windsurf、OpenCode、またはMCP互換のAIアシスタントに接続し、チャットを離れることなく開発環境を管理できます。
lerd mcp:enable-global # 一度登録すれば、すべてのプロジェクトで機能します
そして、尋ねるだけです。
You: set up the project I just cloned
AI: → site(action: "link")
→ exec(action: "composer", args: ["install"])
→ env(action: "setup") # MySQL + Redisを検出し、起動し、DBを作成し、APP_KEYを生成します
→ framework(action: "setup") # Laravelの場合はstorage:link + migrate、Symfonyの場合はdoctrine:migrations:migrate
✓ myapp → https://myapp.test ready
12個のグループ化されたツールがあり、それぞれがactionによって駆動されます:site、service、db、env、runtime、worker、exec、framework、diag、logs、workspace、worktree。プロジェクトのスキャフォールド、マイグレーションの実行、サービスの管理、ワーカーの切り替え、ログのテアリングと検索、Xdebugの有効化、データベースとPHP拡張機能の管理、ディレクトリのパーキング、PHP-FPMとFrankenPHP間のランタイムの切り替えなど、すべてAIアシスタントから行えます。
Lerdを選ぶ理由?
| Lerd | Laravel Herd | Laragon | DDEV | Lando | Sail | |
|---|---|---|---|---|---|---|
| Linux | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ |
| macOS | ✅ | ✅ | ❌ | ✅ | ✅ | ✅ |
| Windows | 🧪 | ✅ | ✅ | ✅ | ✅ | ✅ |
| Podman-native | ✅ | ❌ | ❌ | 🟡 | ❌ | ❌ |
| Rootless | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Open source | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ |
| Free, no paid tier | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ |
| Zero per-project config | ✅ | ✅ | ✅ | ❌ | ❌ | ❌ |
| Git worktrees as sites | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Web UI | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| Terminal dashboard | ✅ | ❌ | ❌ | ❌ | ❌ | ❌ |
| Profiler & debug window | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
| MCP server | ✅ | ✅ | ❌ | ❌ | ❌ | ❌ |
🟡 DDEVはデフォルトでDocker上で動作し、Podmanを代替ランタイムとして使用することもできます。Lerdはrootless Podman専用に構築されています。
🧪 LerdのWindowsサポートはWSL2内で動作し、現在はベータ版です。Windows (WSL2) ガイドを参照してください。LaragonはWindowsネイティブで動作し、LinuxまたはmacOSビルドはありません。こちらに来られた方は、Laragon for Linuxを参照してください。
インストール
Linux
curl -fsSL https://lerd.sh/install.sh | bash
後で更新するには:
lerd update
ベータ版はプレリリースとして公開されるため、通常のインストーラーはスキップします。そのため、初回インストールまたはアップデート時にベータ版を要求するにはbash -s -- --betaを使用します。
aptでインストール(Ubuntu/Debian)
PPAは、標準サポート中のすべてのUbuntuリリースと現在の開発リリース向けに公開されています。それらのいずれかでは:
sudo add-apt-repository ppa:lerd/lerd
sudo apt update
sudo apt install lerd
他のリリースではPPAにパッケージがなく、add-apt-repositoryは後でapt updateが失敗するソースエントリを残します。sudo add-apt-repository --remove ppa:lerd/lerdで削除し、上記のスクリプトインストーラーを使用してください。
パッケージはプロンプトなしでセットアップを完了します。メンテナー スクリプトがルートレベルのステップを適用し、ユーザーごとのインストールを実行するため、.test DNSとHTTPSが自動的に設定されます。sudo apt upgradeで更新します。パッケージ化されたlerdは/usrの下に配置されるため、lerd updateはパッケージマネージャーと競合するのではなく、パッケージマネージャーに委譲します。
dnfでインストール(Fedora)
COPRは、標準サポート中のすべてのFedoraリリースとrawhide向けにビルドされています:
sudo dnf copr enable georged/lerd
sudo dnf install lerd
パッケージはaptと同様に、プロンプトなしでセットアップを完了します。.test DNSとHTTPSが自動的に設定されます。sudo dnf upgradeで更新します。パッケージ化されたlerdは/usrの下に配置されるため、lerd updateはパッケージマネージャーと競合するのではなく、パッケージマネージャーに委譲します。
Homebrewでインストール
brew install lerd-env/lerd/lerd
lerd install
Podmanはディストリビューションから取得され、brewの依存関係としては提供されません。Linux上のHomebrewには通常の前提条件(特にCコンパイラ)が必要です。brew upgrade lerdで更新します。
macOS
curl -fsSL https://lerd.sh/install.sh | bash
後で更新するには:
lerd update
インストーラーはpodman CLIを必要とします。見つからない場合はbrew install podmanを提案します。
Homebrewでインストール
brew install lerd-env/lerd/lerd
lerd install
最近のHomebrewバージョンでは、信頼されるまでサードパーティのタップがブロックされるため、最初にbrew trust lerd-env/lerdを実行する必要がある場合があります。後でbrew upgrade lerd && lerd installで更新します。
NixOS
NixOSには独自のflakeがあります。その宣言的なモデルは、ワンライナーインストーラーの命令的なDNSとセルフインストールのステップには適合しません。
nix run github:lerd-env/lerd-nixos -- --help
lerd-nixos flakeはバイナリをパッケージ化し、スタックに必要なconfiguration.nixブロックを提供します。完全なランブックについては、NixOSガイドを参照してください。
デスクトップアプリ(オプション)
ブラウザタブよりも専用ウィンドウを好みますか? Lerd Desktopは、ダッシュボードをネイティブアプリにラップし、キャプチャされたメール、ワーカー障害、完了した操作のためのネイティブデスクトップ通知を提供します。ブラウザは不要です。LinuxではFlatpakとして提供されます:
flatpak install --user https://lerd.sh/lerd.flatpakref
インストール後、lerd dashboardはブラウザではなくアプリを開きます。
クイックスタート
cd my-laravel-project
lerd link
# → https://my-laravel-project.test
lerd open # ブラウザでサイトを開く
lerd code # エディタでプロジェクトを開く
ゼロから始める場合、lerd newはストアからどのフレームワークとメジャーバージョンを選択するかを尋ね、それをスキャフォールドし、結果をリンクするため、3つのコマンドを入力する代わりに、起動したサイトにアクセスできます。
lerd installは初回実行時にすべてを起動するため、すぐにlerd linkを実行できます。日常的には:
lerd start # DNS、nginx、PHP-FPM、サービス、ワーカー、UIを起動
lerd stop # コンテナとワーカーを停止(UIとウォッチャーは起動したまま)
lerd quit # UI、ウォッチャー、トレイを含む完全シャットダウン
lerd autostart enable # ログイン時にlerdを起動
lerd status # ヘルススナップショット
完全なライフサイクルリファレンスについては、Start, Stop & Autostartを参照してください。
フレームワークストア
lerd-env/frameworksからコミュニティフレームワーク定義をインストールします:
lerd framework search # すべての利用可能なものをリスト表示
lerd framework install symfony # composer.lockからバージョンを自動検出
lerd framework install drupal@11 # 明示的なバージョン
lerd framework list --check # ローカルとストアを比較
フレームワークはlerd link時に自動検出され、そのワーカー、環境値、nginxプロキシ、セットアップコマンドがそこから設定されます。
サービスも同様に機能します。Lerdはデフォルトのスタックを提供し、すべての追加アドオンはlerd-env/servicesにあり、lerdを更新せずに新しいサービスを利用できます:
lerd service search # ストアを閲覧
lerd service preset pgadmin # ストア限定プリセットをインストール
ドキュメント
📖 lerd.sh
スポンサー
Lerdは無料のオープンソースであり、スポンサーである個人や企業によって支えられています。スポンサーになる。
チーム全体でLerdを使用していますか?オンボーディング、優先修正、スタックのヘルプを含む商用サポートが利用可能です。george@dumitres.coまでお問い合わせください。
企業
バックグラウンド
Edward van Tonder · rolaca11 · rais · Anca Emcken · Allen
基盤となる技術
Lerdは、エクスペリエンスを強化するためにバンドルまたは取得する優れたオープンソースプロジェクトのセットの上に成り立っています:
- phpantom_lsp - Tinkerのオートコンプリート、診断、セマンティックハイライトの背後にあるPHP言語サーバー
- Monaco - すべてのブラウザ内編集サーフェスのエディタエンジン
- php-spx - SPXフレアグラフの背後にあるプロファイラー
- mkcert -
.testHTTPSをサポートするローカルCA - mise - 新規インストール時のプロジェクトごとのNodeバージョンマネージャー
- fnm - miseの前にセットアップされるNodeバージョンマネージャーインストール
- static-php-cli - プロジェクト固有のバンドルランタイムに必要な拡張機能が欠けている場合に、lerdがフォールバックする事前ビルド済み静的PHPバイナリ
- Composer - 依存関係操作のためにホストで取得
- Starship - コンテナシェルドロップインのプロンプト
- Simple Icons - ダッシュボード内のサービスマーク、CC0
ライセンス
lerdはMITライセンスです。LICENSEを参照してください。
バイナリは、リンクされたGoモジュールとダッシュボードのビルド元であるnpmパッケージのコードも含まれています。それらの著作権表示とライセンス条件は、THIRD-PARTY-LICENSES.mdに記載されており、すべてのリリースアーカイブに含まれ、バイナリ自体に埋め込まれているため、lerd licensesはどのマシンでもそれを表示します。このファイルは、make licensesによって実際の依存関係グラフから生成され、CIはそれが変更された場合に失敗します。
実行時にマシンにダウンロードされるツール(上記にリストされている)は、lerdによって再配布されず、インストールされている場所に独自のライセンスを保持します。