Skip to content
OneSheet is a simple single sheet excel/xlsx file writer for php 5.4+ & 7+
PHP
Branch: master
Clone or download
nimmneun Addresses issue #46 to introduce repeatable rows / titles when printi… (
#47)

* Addresses issue #46 to introduce repeatable rows / titles when printing a excel file

* specify dist: trusty in travis.yml to allow php 5.4 tests to run

* specify dist: trusty in travis.yml to allow php 5.4 tests to run
Latest commit 724f3d0 Jul 8, 2019

README.md

OneSheet

Build Status Scrutinizer Code Quality Code Coverage

OneSheet is a simple single sheet excel/xlsx file writer for PHP 5 and PHP 7 with cell auto-sizing and styling support.

alt text

What it does

  • Write a single spreadsheet fast and with a small memory footprint.
  • Freeze the first [n] rows to have a fixed table header/headline.
  • Use different fonts, styles, borders and background colors on a row level.
  • Set your own custom column width per column.
  • Autosize column widths to fit cell contents. If no fonts are found, rough estimates are used.
  • Define minimum and maximum column widths to keep exceptionally large or small cell contents in check.

What it doesnt

  • No cell individualisation, everything is applied at a row level.
  • No calculated / formula cells.
  • No conditional formatting.
  • No number formats.
  • No charts.

Install via composer

$ composer require nimmneun/onesheet

Manual installation

If you can't or don't want to use composer for some reason, download & extract onsheet and require the file autoload.php from the releases root folder.

<?php
// path to onesheet autoload file on your server / webspace e.g.:
require_once '/srv/fancydomain.com/libs/onesheet/autoload.php';

Minimal working example

<?php

require_once '../vendor/autoload.php';

$onesheet = new \OneSheet\Writer('/optional/fonts/directory');
$onesheet->addRow(array('hello', 'world'));
$onesheet->writeToFile('hello_world.xlsx');

Available Writer operations

Writer::setFreezePaneCellId(string $cellId)
Writer::setPrintTitleRange(int $startRow, int $endRow)
Writer::setFixedColumnWidths(array $columnWidths)
Writer::setColumnWidthLimits(float $minWidth, float $maxWidth)
Writer::enableCellAutosizing()
Writer::disableCellAutosizing()
Writer::addRows(array $rows, Style $style)
Writer::addRow(array $row, Style $style)
Writer::writeToFile(string $fileName)
Writer::writeToBrowser(string $fileName)

Adding font styles

Style::setFontName(string $name)
Style::setFontSize(int $size)
Style::setFontColor(string $color)
Style::setFontBold()
Style::setFontItalic()
Style::setFontUnderline()
Style::setFontStrikethrough()

Adding background colors (fills)

Style::setFillColor(string $color)

Adding borders

Style::setSurroundingBorder(string $style, string $color)
Style::setBorderLeft(string $style, string $color)
Style::setBorderRight(string $style, string $color)
Style::setBorderTop(string $style, string $color)
Style::setBorderBottom(string $style, string $color)
Style::setBorderDiagonalUp(string $style, string $color)
Style::setBorderDiagonalDown(string $style, string $color)

Cell autosizing

... is cool, but comes with heavy performance impacts - especially when dealing with multibyte characters like ä, ß, Æ, ポ.

Keep in mind though ... you can improve runtimes for larger datasets by disabling it after adding a decent number of rows.

Impacts of autosizing 100k rows * 10 cols * 5 chars 100k rows * 10 cols * 10 chars 100k rows * 10 cols * 20 chars 100k rows * 10 cols * 40 chars
Autosizing OFF (Single Byte Chars) 18 seconds 18 seconds 19 seconds 20 seconds
Autosizing ON (Single Byte Chars) 23 seconds (+27%) 27 seconds (+50%) 34 seconds (+78%) 49 seconds (+145%)
Autosizing OFF (Multi Byte Chars) 20 seconds 21 seconds 23 seconds 26 seconds
Autosizing ON (Multi Byte Chars) 29 seconds (+45%) 36 seconds (+71%) 47 seconds (+104%) 69 seconds (+126%)

Additional examples

<?php

require_once '../vendor/autoload.php';

// create a header style
$headerStyle = (new \OneSheet\Style\Style())
    ->setFontSize(13)
    ->setFontBold()
    ->setFontColor('FFFFFF')
    ->setFillColor('777777');

// create a data style
$dataStyle1 = (new \OneSheet\Style\Style());
    ->setFontName('Segoe UI')
    ->setFontSize(10);

// create a second data style
$dataStyle2 = (new \OneSheet\Style\Style());
    ->setFontName('Arial')
    ->setFillColor('F7F7F7');

// prepare some dummy header data
$dummyHeader = array('Strings', 'Ints', 'Floats', 'Dates', 'Times', 'Uids');

// prepare some dummy data
$dummyData = array();
for ($i = 1; $i <= 100; $i++) {
    $dummyData[] = array(
        substr(md5(microtime()), rand(11,22)),
        rand(333,333333),
        microtime(1),
        date(DATE_RSS, time() + $i*60*60*24),
        date('H:i:s', time() + $i),
        uniqid(null, 1)
    );
}

// create new OneSheet instance
$onesheet = new \OneSheet\Writer();

// add header with style
$onesheet->addRow($dummyHeader, $headerStyle);

// freeze everything above cell A2 (the first row will be frozen)
$onesheet->setFreezePaneCellId('A2');

// enable autosizing of column widths and row heights
$onesheet->enableCellAutosizing();

// add dummy data row by row and switch between styles
foreach ($dummyData as $key=> $data) {
    if ($key % 2) {
        $onesheet->addRow($data, $dataStyle1);
    } else {
        $onesheet->addRow($data, $dataStyle2);
    }
}

// ignore the coming rows for autosizing
$onesheet->disableCellAutosizing();

// add an oversized dummy row
$onesheet->addRow(array('no one cares about my size and I dont even have a special style!'));

// add the all the dummy rows once more, because we can =)
$onesheet->addRows($dummyData);

// Override column widths for columns 6, 7, 8 (column 0 is the first)
$onesheet->setFixedColumnWidths(array(5 => 10, 6 => 10, 7 => 10));

// write everything to the specified file
$onesheet->writeToFile(str_replace('.php', '_onesheet.xlsx', __FILE__));

Issues, bugs, features and ...

Feel free to report any sightings =).

You can’t perform that action at this time.