注意：このドキュメントでは、英語版のリビジョン 22760 の更新内容をスキップしています。

Zend_Text_Table は、さまざまなデコレータを使用して テキストベースの表をその場で作成するためのコンポーネントです。 これは、たとえばテキスト形式のメールで構造化されたデータを送信したい場合などに便利です。 その場合は等幅フォントを使う必要があります。 また、CLI アプリケーションで表形式の情報を表示する場合にも便利です。 Zend_Text_Table は、複数行にわたるカラムやカラムの連結、 テキストの配置の指定に対応しています。

Zend_Text_Table オブジェクトは行の集まりで構成されており、 行は列の集まりで構成されています。行と列を表すのが、それぞれ Zend_Text_Table_Row および Zend_Text_Table_Column です。 表を作成する際に、表のオプションを配列で指定できます。 指定できるオプションは次のとおりです。

表に行を追加するには、 Zend_Text_Table_Row のインスタンスを作成して、それを appendRow メソッドで追加します。行自体には何もオプションはありません。 配列を直接 appendRow メソッドに渡すこともできます。 この場合は、複数の列オブジェクトからなる行オブジェクトに自動的に変換されます。

行に列を追加する方法も同じです。 Zend_Text_Table_Column のインスタンスを作成し、 列のオプションをコンストラクタで指定するか、あるいは後から set* メソッドで設定します。 最初のパラメータは列の中身で、これは複数行にすることもできます。 複数行にする場合は \n で行を区切ります。 2 番目のパラメータは配置を指定します。デフォルトは左詰めで、 Zend_Text_Table_Column のクラス定数のいずれかを指定できます。

3 番目のパラメータは列の連結 (colspan) を指定します。 たとえば、このパラメータに "2" を指定すると、 表の中で 2 つの列が連結されるようになります。 最後のパラメータは列の中身のエンコーディングです。 ASCII および UTF-8 以外を使用する場合は必ず指定しなければなりません。 行を列に追加するには、行オブジェクトの appendColumn のパラメータに列オブジェクトを指定してコールします。 あるいは、文字列を直接 appendColumn メソッドに渡すこともできます。

最後に、表をレンダリングするには render メソッドを使用します。あるいは、 echo $table; や $tableString = (string) $table などとしてマジックメソッド __toString を使用することもできます。

$table = new Zend_Text_Table(array('columnWidths' => array(10, 20)));

// シンプルな例
$table->appendRow(array('Zend', 'Framework'));

// あるいは冗長な例
$row = new Zend_Text_Table_Row();

$row->appendColumn(new Zend_Text_Table_Column('Zend'));
$row->appendColumn(new Zend_Text_Table_Column('Framework'));

$table->appendRow($row);

echo $table;

┌──────────┬────────────────────┐
│Zend      │Framework           │
└──────────┴────────────────────┘