PHPackages                             suzumaze/dirdoc - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. suzumaze/dirdoc

ActiveLibrary[Utility & Helpers](/categories/utility)

suzumaze/dirdoc
===============

プロジェクトのディレクトリ構造をドキュメント化するためのツール

0.1.0(1y ago)14MITPHPPHP ^8.1

Since Mar 19Pushed 1y ago1 watchersCompare

[ Source](https://github.com/suzumaze/DirDoc)[ Packagist](https://packagist.org/packages/suzumaze/dirdoc)[ RSS](/packages/suzumaze-dirdoc/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (5)Versions (2)Used By (0)

DirDoc
======

[](#dirdoc)

DirDocは、プロジェクトのディレクトリ構造を可視化してドキュメント化するためのPHPパッケージです。

概要
--

[](#概要)

プロジェクトに新しく参加したり、しばらく離れていた後に戻ったりすると、暗黙的な情報の多さに戸惑うことはありませんか？特に問題となるのがディレクトリ構造とファイル構成です。

DirDocは、こうした問題を解決するシンプルなツールで、以下のことを実現します：

1. プロジェクトのディレクトリ構造とルートファイルを自動的にJSON形式で記録
2. 各ディレクトリやファイルに説明文を追加する仕組みの提供
3. 実際のプロジェクト構造とJSON記録の差分を検出
4. 説明が不足している項目の特定と通知

インストール
------

[](#インストール)

Composerを使用してインストールします：

```
composer require suzumaze/dirdoc
```

使い方
---

[](#使い方)

### 基本的な使い方

[](#基本的な使い方)

```
composer dirdoc
```

このコマンド一つで以下の処理を実行します：

1. `dirdoc.json`が存在しない場合は新規作成
2. 既存の`dirdoc.json`と実際のディレクトリ構造を比較
3. 説明が不足しているディレクトリやファイルを検出して出力

### オプション

[](#オプション)

```
composer dirdoc -- --config=custom-config.json  # カスタム設定ファイルを指定
composer dirdoc -- --output=custom-output.json  # 出力ファイルを指定
composer dirdoc -- --scan-only                  # スキャンのみを実行
composer dirdoc -- --validate-only              # 既存のJSONファイルの検証のみを実行
composer dirdoc -- -v                           # 詳細な出力を表示
```

### 出力形式

[](#出力形式)

DirDocの出力は使いやすいように最適化されています：

- **基本モード**: 重要な情報のみがシンプルに表示されます
- **詳細モード** (`-v`): 処理の各ステップが詳細に表示されます

### 変更検出

[](#変更検出)

実行時、以下のような変更が検出されます：

- **新しく追加されたアイテム**: ファイルシステムにあるが、まだJSONに記録されていないアイテム
- **削除されたアイテム**: JSONに記録されているが、現在のファイルシステムには存在しないアイテム
- **説明不足のアイテム**: 説明が不足しているか、説明が短すぎるアイテム

設定ファイル
------

[](#設定ファイル)

デフォルトでは`dirdoc.config.json`という名前の設定ファイルを使用します。以下は設定ファイルの例です：

```
{
  "scan": {
    "root": ".",
    "depth": {
      "default": 1,
      "directories": {
        "src": 3,
        "tests": 2
      }
    },
    "exclude": {
      "patterns": [
        "vendor/*",
        "node_modules/*",
        ".git/*"
      ],
      "files": [
        "*.log",
        "*.cache"
      ]
    },
    "include": {
      "root_files": true,
      "empty_directories": false
    }
  },
  "validation": {
    "require_description": true,
    "min_description_length": 10
  }
}
```

### 設定項目の説明

[](#設定項目の説明)

#### スキャン設定 (`scan`)

[](#スキャン設定-scan)

- `root`: スキャンを開始するルートディレクトリ
- `depth`:
    - `default`: デフォルトのスキャン深さ
    - `directories`: 特定のディレクトリに対するスキャン深さの設定
- `exclude`:
    - `patterns`: 除外するパターン (globパターン)
    - `files`: 除外するファイルパターン
- `include`:
    - `root_files`: ルートディレクトリのファイルを含めるかどうか
    - `empty_directories`: 空のディレクトリを含めるかどうか

#### バリデーション設定 (`validation`)

[](#バリデーション設定-validation)

- `require_description`: 説明が必須かどうか
- `min_description_length`: 最小説明文字数

出力されるJSONの形式
------------

[](#出力されるjsonの形式)

DirDocは以下のような形式のJSONを生成します。ディレクトリとファイルは自動的に整理され、ディレクトリが先に、次にファイルが表示されます：

```
{
  "name": "project-root",
  "type": "directory",
  "description": "プロジェクトのルートディレクトリ",
  "children": [
    {
      "name": "src",
      "type": "directory",
      "description": "ソースコードが格納されるディレクトリ",
      "children": [
        {
          "name": "Controller",
          "type": "directory",
          "description": "コントローラークラスを格納するディレクトリ",
          "children": []
        }
      ]
    },
    {
      "name": "README.md",
      "type": "file",
      "description": "プロジェクトの説明ファイル"
    }
  ]
}
```

一般的なディレクトリと説明
-------------

[](#一般的なディレクトリと説明)

以下は標準的なプロジェクト構造における一般的なディレクトリとその説明例です：

ディレクトリ/ファイル説明例src/ソースコードが格納されるディレクトリtests/テストコードが格納されるディレクトリbin/実行可能ファイルが格納されるディレクトリconfig/設定ファイルが格納されるディレクトリpublic/公開用ファイルが格納されるディレクトリvendor/Composerによって管理される外部依存パッケージが格納されるディレクトリcomposer.jsonComposerパッケージの設定および依存関係を定義するファイルREADME.mdプロジェクトの概要と使用方法を説明するドキュメント機能と特徴
-----

[](#機能と特徴)

- **シンプルなインターフェース**: 必要最小限の情報表示でストレスなく使用可能
- **自動ソート**: ディレクトリが先、ファイルが後という整理された表示
- **パス簡略化**: 長いパスを簡潔に表示し、視認性を向上
- **変更通知の改善**: 追加・削除されたアイテムを明確に表示
- **詳細表示モード**: `-v` オプションで詳細な処理情報を確認可能

ユースケース
------

[](#ユースケース)

- 新メンバーが短時間でプロジェクト構造を理解できるようにする
- 暗黙知となっているディレクトリ構造の役割を明文化する
- プロジェクト構造の変更履歴を追跡する（Gitで`dirdoc.json`を管理）
- ドキュメントのメンテナンスを簡単にし、最新の状態を保つ

対象ユーザー
------

[](#対象ユーザー)

主にチーム開発を行うエンジニアを対象としていますが、個人開発者にも有用です。特に以下のようなケースで役立ちます：

- 新メンバーのオンボーディングを効率化したいチーム
- プロジェクト構造の一貫性と透明性を維持したい開発リーダー
- 長期間にわたって保守する必要があるプロジェクト
- ドキュメント管理を自動化・効率化したい開発者

ライセンス
-----

[](#ライセンス)

MIT License

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance48

Moderate activity, may be stable

Popularity5

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity35

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

416d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/6fce2402963022ca3508f1ff7b46acdc50d999774897c91a198817038e171ad9?d=identicon)[suzumaze](/maintainers/suzumaze)

---

Top Contributors

[![suzumaze](https://avatars.githubusercontent.com/u/17695387?v=4)](https://github.com/suzumaze "suzumaze (1 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisRector

### Embed Badge

![Health badge](/badges/suzumaze-dirdoc/health.svg)

```
[![Health](https://phpackages.com/badges/suzumaze-dirdoc/health.svg)](https://phpackages.com/packages/suzumaze-dirdoc)
```

###  Alternatives

[symfony/maker-bundle

Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code.

3.4k111.1M560](/packages/symfony-maker-bundle)[phpro/soap-client

A general purpose SoapClient library

8885.6M45](/packages/phpro-soap-client)[symplify/monorepo-builder

Not only Composer tools to build a Monorepo.

5205.3M81](/packages/symplify-monorepo-builder)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[ramsey/conventional-commits

A PHP library for creating and validating commit messages according to the Conventional Commits specification. Includes a CaptainHook action!

1931.2M120](/packages/ramsey-conventional-commits)[cognesy/instructor-php

The complete AI toolkit for PHP: unified LLM API, structured outputs, agents, and coding agent control

310107.9k1](/packages/cognesy-instructor-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)