PHPackages bojaghi/custom-tables - 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. bojaghi/custom-tables ActiveLibrary[Utility & Helpers](/categories/utility) bojaghi/custom-tables ===================== 커스텀 테이블을 위한 보자기 유틸리티. 1.0.6(1mo ago)026GPL-2.0-or-laterPHPPHP >=8.0 Since May 2Pushed 1mo ago1 watchersCompare [ Source](https://github.com/bojaghi/custom-tables)[ Packagist](https://packagist.org/packages/bojaghi/custom-tables)[ Docs](https://github.com/bojaghi/custom-tables)[ RSS](/packages/bojaghi-custom-tables/feed)WikiDiscussions main Synced 3w ago READMEChangelogDependencies (10)Versions (8)Used By (0) Custom Tables ============= [](#custom-tables) 커스텀 테이블을 위한 유틸리티. 워드프레스 기능을 더 확장하기 위해 플러그인이나 테마는 고유의 테이블을 별도로 생성할 수 있습니다. 이 때 활용되는 상용구적인 패턴을 재활용할 수 있게 하기 위해 이 유틸리티를 제공합니다. 설정하기 ---- [](#설정하기) 예시: ``` use Bojaghi\CustomTables\CustomTables; new CustomTableFactory( [ /*...*/ ], // Enter configuration array. 설정을 담은 배열을 넣거나. [ /*...*/ ], // Enter table definition array. 테이블 설정을 담은 배열을 넣거나. ) /* OR */ new CustomTables( '/path/to/settings', // Enter path to configuration file. 설정을 담은 파일 경로를 문자열로. '/path/to/table-def', // Enter path to table definition file. 테이블 설정을 담은 파일 경로를 문자열로. ) ``` 이 객체는 가능한 액션과 필터의 콜백에서 생성하지 말고, 플러그인/테마 코드 실행시 생성되게 해 주세요. ### 설정 파일의 예제 [](#설정-파일의-예제) ``` if (!defined('ABSPATH')) { exit; } return [ 'version_name' => 'my_version_name', // Optional 'version' => '1.0.0', // Optional 'is_theme' => false, // Optional, defaults to false. 'main_file' => __FILE__, // Optional, defaults to blank. 'activation' => false, // Optional, defaults to false. Create tables on activation. 'deactivation' => false, // Optional, defaults to false. Delete tables on deactivation. 'uninstall' => false, // Optional, defaults to false. Delete tables on uninstall. 'suppress_errors' => false, // Optional, defaults to false. ]; ``` - version\_name: 옵션에 저장할 데이터베이스 버전의 옵션 이름입니다. 다른 옵션과 충돌되지 않는 유일한 이름으로 지어주세요. - version: 이 설정의 버전을 적어주세요. 기존 플러그인에 기록된 버전보다 이 버전이 높으면 테이블 업데이트를 진행합니다. - is\_theme: 이 코드가 테마에서 동작하는지, 플러그인에서 동작하는지를 지정합니다. - mani\_file: `is_theme`이 `false`인 경우, 플러그인의 메인 파일을 지정합니다. - activation: 이 코드가 동작하는 테마가 선택되었을 때, 또는 플러그인이 활성화 되었을 때 테이블을 **생성**합니다. - deactivation: 이 코드가 동작하는 테마가 다른 테마로 변경될 때, 또는 플러그인이 비활성화될 때 테이블을 **삭제(주의!!)** 합니다 - uninstall: 이 코드가 동작하는 테마, 또는 플러그인이 삭제될 때 테이블을 **삭제(주의!!)** 합니다. - suppress\_errors: `$wpdb->suppress_error` 파라미터를 조정합니다. ### 테이블 설정 파일의 예제 [](#테이블-설정-파일의-예제) ``` if (!defined('ABSPATH')) { exit; } /** * How to create table * * This method uses dbDelta() function. * * Please keep in mind that dbDelta() is rather demanding: * - You must put each field on its own line in your SQL statement. * - You must have two spaces between the words PRIMARY KEY and the definition of your primary key. * - You must use the key word KEY rather than its synonym INDEX and you must include at least one KEY. * - KEY must be followed by a SINGLE SPACE then the key name then a space then open parenthesis with the field name * then a closed parenthesis. * - You must not use any apostrophes or backticks around field names. * - Field types must be all lowercase. * - SQL keywords, like CREATE TABLE and UPDATE, must be uppercase. * - You must specify the length of all fields that accept a length parameter. int(11), for example. * - Use 'UNIQUE KEY', not just 'UNIQUE'. Likewise, use 'FULLTEXT KEY', and 'SPATIAL KEY'. * * @return array * @link https://codex.wordpress.org/Creating_Tables_with_Plugins */ return [ [ 'table_name' => 'table_name', 'table_comment' => '', // Optional, table comment 'field' => [ 'id bigint(20) unsigned NOT NULL AUTO_INCREMENT', 'name varchar(100) NOT NULL', 'count bigint(20) unsigned NOT NULL', ], 'index' => [ 'PRIMARY KEY (id)', // Two spaces after 'PRIMARY KEY'. 'PRIMARY KEY' 다음 두 개의 공백. 'UNIQUE KEY uni_name (name)', // Just as-is, from here. 여기부터는 그대로. 'FULLTEXT KEY idx_name (name)', 'KEY idx_count (count)', ], 'engine' => 'InnoDB', // Optional, defaults to 'InnoDB'. 'charset' => '', // Optional, leave blank to use the default value of $wpdb. 'collate' => '', // Optional, leave blank to use the default value of $wpdb. ], /* ... */ ]; ``` ### `version_name`, `version`의 의미 [](#version_name-version의-의미) `version_name`, `version`이 설정되어 있으면 테이블 생성 후 옵션 테이블에 기록된 버전 `version`을 기록합니다. 이 때 옵션 이름으로 `version_name`을 사용합니다. 그러므로 이름은 고유한 값을 가질 수 있도록 해 주세요. `version`값으로 PHP `version_compare()` 함수가 인식할 수 있는 버전 문자열을 사용하세요. 이렇게 값이 설정되면 데이터베이스 업데이트 시, 굳이 플러그인을 활성화/비활성화 하지 않아도 자동으로 데이터베이스를 업그레이드 할 수 있습니다. 이 기능을 사용하지 않으려면 값을 비워 두거나 키-값 쌍을 삭제하세요. ### 플러그인, 테마 기반 구분 [](#플러그인-테마-기반-구분) 플러그인의 경우 `main_file` 값을 넣는 것이 좋습니다. 그래야 활성화/비활성화/삭제시 테이블 생성, 제거 작업이 가능합니다. 만약 테마 기반에서 실행한다면 `is_theme` 값을 참으로 설정해 둡니다. 그러면 `main_file`은 무시됩니다. ### 활성화/비활성화/삭제 [](#활성화비활성화삭제) 아래는 모두 기본값이 `false`입니다. - `activation`: 플러그인/테마 활성화 시 테이블을 자동으로 만듭니다. - `deactivation`: 플러그인/테마 비활성화 시 테이블을 자동으로 **삭제**합니다. - `uninstall`: 플러그인/테마 삭제 시 테이블을 자동으로 **삭제**합니다. ### suppress\_errors [](#suppress_errors) ### Health Score 40 — FairBetter than 86% of packages Maintenance90 Actively maintained with recent releases Popularity8 Limited adoption so far Community7 Small or concentrated contributor base Maturity47 Maturing project, gaining track record 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 ~62 days Recently: every ~93 days Total 7 Last Release 46d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/8bbfd1d4316ffdccc98504cdbdd210c69a6add7dca21678ad402ccedb3ff4764?d=identicon)[ep6tri](/maintainers/ep6tri) --- Top Contributors [![chwnam](https://avatars.githubusercontent.com/u/6630320?v=4)](https://github.com/chwnam "chwnam (8 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/bojaghi-custom-tables/health.svg) ``` [![Health](https://phpackages.com/badges/bojaghi-custom-tables/health.svg)](https://phpackages.com/packages/bojaghi-custom-tables) ``` ### Alternatives [jeroendesloovere/distance Get distance between two locations using PHP. 3464.4k](/packages/jeroendesloovere-distance) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)