PHPackages iamapen/commentable-data-set - 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. [Testing & Quality](/categories/testing) 4. / 5. iamapen/commentable-data-set ActiveLibrary[Testing & Quality](/categories/testing) iamapen/commentable-data-set ============================ Commentable CSV DataSet for DBUnit 5.0.1(6y ago)0183[4 issues](https://github.com/iamapen/dbunit-CommentableDataSet/issues)MITPHPPHP ^7.2CI failing Since Jan 17Pushed 6y ago1 watchersCompare [ Source](https://github.com/iamapen/dbunit-CommentableDataSet)[ Packagist](https://packagist.org/packages/iamapen/commentable-data-set)[ Docs](https://github.com/iamapen/dbunit-CommentableDataSet)[ RSS](/packages/iamapen-commentable-data-set/feed)WikiDiscussions 5.0.x Synced 2mo ago READMEChangelogDependencies (2)Versions (17)Used By (0) dbunit Commentable DataSet ========================== [](#dbunit-commentable-dataset) phpunit/dbunit 用の DataSet や Operation の詰め合わせ。 [iamapen/excel-friendly-data-set](https://packagist.org/packages/iamapen/excel-friendly-data-set) の後継。 DBレコードを「1列目がコメントのCSV」で表現するための CsvDataSet など。 [![CircleCI](https://camo.githubusercontent.com/c8dc77fb36c100862ff70c0451db6d7996662e39f94d8dbe8ee2d78cf3893da6/68747470733a2f2f636972636c6563692e636f6d2f67682f69616d6170656e2f6462756e69742d436f6d6d656e7461626c65446174615365742e7376673f7374796c653d736869656c64)](https://circleci.com/gh/iamapen/dbunit-CommentableDataSet) Install ======= [](#install) UT用なので `require --dev` になる。 ``` composer require --dev iamapen/commentable-data-set ``` 手動で composer.json に書く場合 ``` require-dev: { "iamapen/commentable-data-set ": "^4.0" } ``` Usage ===== [](#usage) DataSet ------- [](#dataset) ### DataSet/CommentableDataSet [](#datasetcommentabledataset) CSVの左n列をコメント列扱いとして、無視する(取り込まない) 機能を持つ CsvDataSet。 テストデータに対してのコメント列として使える。 ``` $ds = new \Iamapen\CommentableDataSet\DbUnit\DataSet\CommentableCsvDataSet(); $ds->addTable('users', '/PATH/TO/users.csv'); $ds->setIgnoreColumnCount(1); // 1列目をコメント列とする ``` CSVの例 ``` 最初の列はコメント,id,user_name 男性ユーザ,1,taro soramame 女性女性ユーザ,2,arare norimaki 1ヶ月以上ログインしてないユーザ,3,akane kimidori 削除されるユーザ,4,gajira norimaki ``` もちろん他の DataSet との比較もできる ``` class XxxTest extends \PHPUnit\DbUnit\TestCase { function testXXX() { $this->assertDataSetsEqual($ds1, $ds2); } } ``` ### DataSet/ExcelCsvDataSet (deprecated) [](#datasetexcelcsvdataset-deprecated) 最初に作成した DataSet。 Excelで扱いやすい UTF-16-LE(+BOM) のCSVを UTF-8 に変換しながら取り込むもの。 現在は出番はないと思われる。 2007年作成当時は UTF-8 の CSVを満足に編集できるソフトが少ないという経緯で作られた。 しかし現在は LibreOffice-Calc 等のエディタでUTF8のCSVを容易に編集できるため、 わざわざExcel用に UTF-16 で保存しておくこともない。 以下、旧 README のまま。 > Excelでは UTF-8 のcsvをまともに編集(とくに保存)ができないが、 UTF-16-LE(+BOM) にすれば「D&Dで開く」「Ctrl+S」で保存など比較的自然に編集でき、 テストデータにUnicode文字も使える。 > > 代わりにテストコード内で UTF-16 -> UTF-8 変換が必要になるので、これを行う。 > > なおExcelからは"Unicode", sakuraエディタでは"Unicode", vimでは"utf16le", mbstringでは"UTF-16"で扱える。 新規CSV作成時はテキストエディタでUTF-16のファイルを作成してそれをExcelにD&Dするのが楽そう。 > > xxTest.php > > ``` > $ds = new Iamapen\ExcelFriendlyDataSet\Database\DataSet\ExcelCsvDataSet(); > ``` Operation --------- [](#operation) ### Operation/MySqlBulkInsert [](#operationmysqlbulkinsert) `PHPUnit_Extensions_Database_Operation_Insert` のバルクインサート版。 MySQL専用。(一応SQLiteでも動く) あまりに入力CSVが大きいと、`max_allowed_packet` の制限にかかる可能性がある。これは課題。 ``` use Iamapen\CommentableDataSet\DbUnit\DataSet\CommentableCsvDataSet; use Iamapen\CommentableDataSet\DbUnit\Operation\MySqlBulkInsert; // DataSet $ds = new CommentableCsvDataSet(); $ds->addTable('/PATH/TO/CSV'); // 実行 (TRUNCATE -> BULK INSERT) $con = new \PHPUnit\DbUnit\Database\DefaultConnection($pdo); \PHPUnit\DbUnit\Operation\Factory::TRUNCATE()->execute($con, $ds); (new MySqlBulkInsert())->execute($con, $ds); ``` 注意点・課題 ====== [](#注意点課題) - Operation/MySqlBulkInsert - あまりに入力CSVが大きいと `max_allowed_packet` の制限にかかる可能性がある。 - DataSet/ExcelCsvDataSet - もはや非推奨。 UTF-8 で保存して、UTF-8 対応のエディタで編集するのがよい。例えば LibreOffice の Calc でできる。 Excelでやろうというのは、まともなエディタが存在しなかった時代の古いアプローチ。 - 文字コード変換をストリームでやったほうがいい - 正式なプロダクトでの運用実績が少ないため、品質は趣味レベル。 バージョン ===== [](#バージョン) phpphpunitdbunit5.0.x7.2+8.2, 9.x5.x4.0.x7.1+7.x4.x3.0.x7.0+6.x3.x2.0.x5.4+, 7.0+4.x, 5.x2.x1.2.x5.3+3.x, 4.x1.x1.1.x5.3+3.x, 4.x1.x1.0.x (EOL)5.3+3.x1.x ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity10 Limited adoption so far Community7 Small or concentrated contributor base Maturity66 Established project with proven stability 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 Every ~147 days Recently: every ~0 days Total 16 Last Release 2285d ago Major Versions 0.0.2 → 1.0.12016-07-21 1.1.1 → 4.0.02019-01-18 2.0.0 → 3.0.02019-01-18 3.0.0 → 5.0.02020-01-29 1.2.0 → 5.0.x-dev2020-02-05 PHP version history (6 changes)0.0.1PHP >=5.3.1 1.1.0PHP >=5.3.3 4.0.0PHP ^7.1 2.0.0PHP ^5.4|^7.0 3.0.0PHP ^7.0 5.0.0PHP ^7.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/ea7d284aa8645efaa9a36a8c8a4848f90c083363b7a2a1f35fa760a90a2f64b1?d=identicon)[iamapen](/maintainers/iamapen) --- Top Contributors [![iamapen](https://avatars.githubusercontent.com/u/415157?v=4)](https://github.com/iamapen "iamapen (67 commits)") --- Tags csvdbunitphpunitphpunitdbUnit ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/iamapen-commentable-data-set/health.svg) ``` [![Health](https://phpackages.com/badges/iamapen-commentable-data-set/health.svg)](https://phpackages.com/packages/iamapen-commentable-data-set) ``` ### Alternatives [phpunit/phpunit The PHP Unit Testing framework. 20.0k910.7M134.3k](/packages/phpunit-phpunit)[brianium/paratest Parallel testing for PHP 2.5k118.8M753](/packages/brianium-paratest)[johnkary/phpunit-speedtrap Find and report on slow tests in your PHPUnit test suite 78137.2M121](/packages/johnkary-phpunit-speedtrap)[spatie/phpunit-snapshot-assertions Snapshot testing with PHPUnit 69417.9M511](/packages/spatie-phpunit-snapshot-assertions)[dg/bypass-finals Removes final keyword from source code on-the-fly and allows mocking of final methods and classes 56426.3M454](/packages/dg-bypass-finals)[phpspec/prophecy-phpunit Integrating the Prophecy mocking library in PHPUnit test cases 19254.9M1.4k](/packages/phpspec-prophecy-phpunit) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)