PHPackages topdelivery/php-excel-templator - 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. [Templating & Views](/categories/templating) 4. / 5. topdelivery/php-excel-templator ActiveLibrary[Templating & Views](/categories/templating) topdelivery/php-excel-templator =============================== PHP Spreadsheet extension for generating excel files from template v1.0.2(2y ago)15.9k↓100%MITPHPPHP >=5.6.0 Since Nov 14Pushed 2y ago1 watchersCompare [ Source](https://github.com/topdelivery/php-excel-templator)[ Packagist](https://packagist.org/packages/topdelivery/php-excel-templator)[ RSS](/packages/topdelivery-php-excel-templator/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (3)Dependencies (1)Versions (4)Used By (0) PHP Excel Templator =================== [](#php-excel-templator) [![Latest Stable Version](https://camo.githubusercontent.com/f3fbbe8353e10ef75dcd00e8439583639d6c35b81bd01f9d71cb740dddce98ae/68747470733a2f2f706f7365722e707567782e6f72672f746f7064656c69766572792f7068702d657863656c2d74656d706c61746f722f762f737461626c65)](https://packagist.org/packages/topdelivery/php-excel-templator)[![Latest Unstable Version](https://camo.githubusercontent.com/b100bba2044fd3027fa1206c7a7f09bdbba79656438e298fd82e8b5ae2ef6443/68747470733a2f2f706f7365722e707567782e6f72672f746f7064656c69766572792f7068702d657863656c2d74656d706c61746f722f762f756e737461626c65)](https://packagist.org/packages/topdelivery/php-excel-templator)[![License](https://camo.githubusercontent.com/aec13246d7c9bdf8cffd6d309f3b99b5791f0f951508e9cb2adacf14ea775bd7/68747470733a2f2f706f7365722e707567782e6f72672f746f7064656c69766572792f7068702d657863656c2d74656d706c61746f722f6c6963656e7365)](https://packagist.org/packages/topdelivery/php-excel-templator)[![Total Downloads](https://camo.githubusercontent.com/65a0bcb9a210777ebea6f79ccfb9c84febd272e79edbedc4d2c363fe84b91300/68747470733a2f2f706f7365722e707567782e6f72672f746f7064656c69766572792f7068702d657863656c2d74656d706c61746f722f646f776e6c6f616473)](https://packagist.org/packages/topdelivery/php-excel-templator)[![Monthly Downloads](https://camo.githubusercontent.com/6eb768d0facfc4b93d1059e029405bb7bcb3554f7671f6bd878dddff13f787ec/68747470733a2f2f706f7365722e707567782e6f72672f746f7064656c69766572792f7068702d657863656c2d74656d706c61746f722f642f6d6f6e74686c79)](https://packagist.org/packages/topdelivery/php-excel-templator)[![Daily Downloads](https://camo.githubusercontent.com/b309f300f158492a95e0e5a0755d54101d68284b51922993b2aa03a0d2ce617b/68747470733a2f2f706f7365722e707567782e6f72672f746f7064656c69766572792f7068702d657863656c2d74656d706c61746f722f642f6461696c79)](https://packagist.org/packages/topdelivery/php-excel-templator) [Инструкция на русском языке (Russian)](README_ru.md) It's PHP Spreadsheet extension that allows you to export excel files from an excel template. Using the extension you don’t need to create excel files from scratch using code, set styles and so on. Demo screenshot: [![Demo](readme_resources/demo.png)](readme_resources/demo.png) Simple example -------------- [](#simple-example) There is a simplest example of how this might look (using less code). Suppose we have an excel file with the following template variables: [![Template](readme_resources/template.png)](readme_resources/template.png) The code will be as follows: ``` use topdelivery\PhpExcelTemplator\PhpExcelTemplator; require_once('vendor/autoload.php'); // if you don't use framework PhpExcelTemplator::saveToFile('./template.xlsx', './exported_file.xlsx', [ '{current_date}' => date('d-m-Y'), '{department}' => 'Sales department', ]); ``` As a result, we get: [![Exported file](readme_resources/exported_file.png)](readme_resources/exported_file.png) Using this extension, we just create a template file with the styles we need and specify template variables in it. In the code, we just pass the parameters to template variables. Features -------- [](#features) - We can insert several template variables in one table cell (if the data type is "string") - We can insert a one-dimensional array, in this case additional rows will be created in the table - We can insert a two-dimensional array, in this case the respective columns and rows are created in the table - By specifying the value in the cells, you can change the styles of these cells, even when inserting arrays - We can apply the same template on several sheets of the table Features demo and usage examples are given in the folder "samples". Restrictions: ------------- [](#restrictions) - Possible so-called side effects when using one-dimensional or two-dimensional arrays in one sheet. Especially when it is located asymmetrically. An example of side effects is also given in the folder "samples". INSTALLATION: ------------- [](#installation) ``` $ composer require topdelivery/php-excel-templator ``` ### Template variable naming rules [](#template-variable-naming-rules) The rules can be any, but I can offer my recommendation for naming template variables: - {var\_name} - for string values - \[var\_name\] - for one-dimensional arrays - \[\[var\_name\]\] - for two-dimensional arrays ### How to insert a one-dimensional array, so that the table create columns, not rows? [](#how-to-insert-a-one-dimensional-array-so-that-the-table-create-columns-not-rows) To do this, instead of a one-dimensional array, insert a two-dimensional one as follows: ``` $param['[[var_name]]'] = [['text 1', 'text 2', 'text 3']]; ``` Using setters ------------- [](#using-setters) In the example above, the minimum code without setters was used. The data types (for example: a string, a one-dimensional array, or a two-dimensional array) in this code is automatically recognized and the necessary setter is chose. But if we want to use a specific setter, the same code will look like this: ``` use topdelivery\PhpExcelTemplator\PhpExcelTemplator; use topdelivery\PhpExcelTemplator\params\ExcelParam; use topdelivery\PhpExcelTemplator\params\CallbackParam; use topdelivery\PhpExcelTemplator\setters\CellSetterStringValue; require_once('vendor/autoload.php'); // if you don't use framework $params = [ '{current_date}' => new ExcelParam(CellSetterStringValue::class, date('d-m-Y')), '{department}' => new ExcelParam(CellSetterStringValue::class, 'Sales department'), ]; PhpExcelTemplator::saveToFile('./template.xlsx', './exported_file.xlsx', $params); ``` At the moment the extension has 3 kinds of setters: - CellSetterStringValue (for string values) - CellSetterArrayValue (for one-dimensional arrays) - CellSetterArray2DValue (for two-dimensional arrays) You ask, what for specify setters explicitly? - First, because it's flexible: let's say you want to create your own setter with your own algorithms that eliminate the side effects, which I mentioned above. - Secondly, in each setter, you can pass a callback function in which we can change the styles of the inserted cells. For example, you need to highlight with bold font the employees who made the best sales in this month. Examples of code that uses all kinds of setters are listed in the folder "samples". How to set styles without setters? ---------------------------------- [](#how-to-set-styles-without-setters) In most cases to use the setters explicitly is not so convenient. I suppose you want to use minimum code. Therefore, I made it possible to set styles without using setters: ``` use topdelivery\PhpExcelTemplator\PhpExcelTemplator; use topdelivery\PhpExcelTemplator\params\CallbackParam; require_once('vendor/autoload.php'); // if you don't use framework $params = [ '{current_date}' => date('d-m-Y'), '{department}' => 'Sales department', '[sales_amount]' => [ '10230', '45100', '70500', ], ]; $callbacks = [ '[sales_amount]' => function(CallbackParam $param) { $amount = $param->param[$param->row_index]; if ($amount > 50000) { $cell_coordinate = $param->coordinate; $param->sheet->getStyle($cell_coordinate)->getFont()->setBold(true); } }, ]; PhpExcelTemplator::saveToFile('./template.xlsx', './exported_file.xlsx', $params, $callbacks); ``` Special setter for special templates (CellSetterArrayValueSpecial) ------------------------------------------------------------------ [](#special-setter-for-special-templates-cellsetterarrayvaluespecial) There are special templates, which require to insert the whole row, and not insert cell with shifting down. Moreover, it's required to merge cells, as well as the cell in which there was a template variable. [![Special template](readme_resources/special_template.png)](readme_resources/special_template.png) For these templates, a special setter has been created: CellSetterArrayValueSpecial. Examples of code that uses it is given in folder: samples/8\_special\_template. Events ------ [](#events) The following are possible events and an explanation of why they can be applied: ``` $events = [ PhpExcelTemplator::BEFORE_INSERT_PARAMS => function(Worksheet $sheet, array $templateVarsArr) { // fires before inserting values into template variables }, PhpExcelTemplator::AFTER_INSERT_PARAMS => function(Worksheet $sheet, array $templateVarsArr) { // fires after inserting values into template variables. // It is used if you want to insert values​into a spreadsheet after columns and rows have been created. // For example, when inserting an array of images. // If you insert images using $callbacks, then the images can shift to the right due to the fact that on the next line the template variable can create additional columns. // See an example: samples/10_images }, PhpExcelTemplator::BEFORE_SAVE => function(Spreadsheet $spreadsheet, IWriter $writer) { // fires before saving to a file. It is used when you need to modify the $writer or $spreadsheet object before saving, for example, $writer->setPreCalculateFormulas(false); }, ]; $callbacks = []; $templateFile = './template.xlsx'; $fileName = './exported_file.xlsx'; $params = [ // ... ]; PhpExcelTemplator::saveToFile($templateFile, $fileName, $params, $callbacks, $events); ``` ### Health Score 29 — LowBetter than 60% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity23 Limited adoption so far Community7 Small or concentrated contributor base Maturity54 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 ~674 days Total 3 Last Release 1020d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/94f4dae32e7c248127ea42be5976055cf390d126ff25ac46e205b1eccd8686a4?d=identicon)[topdelivery](/maintainers/topdelivery) --- Top Contributors [![topdelivery](https://avatars.githubusercontent.com/u/41336682?v=4)](https://github.com/topdelivery "topdelivery (5 commits)") --- Tags phpexceltemplatetemplatertemplator ### Embed Badge ![Health badge](/badges/topdelivery-php-excel-templator/health.svg) ``` [![Health](https://phpackages.com/badges/topdelivery-php-excel-templator/health.svg)](https://phpackages.com/packages/topdelivery-php-excel-templator) ``` ### Alternatives [alhimik1986/php-excel-templator PHP Spreadsheet extension for generating excel files from template 350336.7k1](/packages/alhimik1986-php-excel-templator)[anourvalar/office Generate documents from existing Excel & Word templates | Export tables to Excel (Grids) 24085.2k](/packages/anourvalar-office) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)