README

此Bundle允许你创建、修改和读取Excel对象。

许可证

版本 2

这是全新的版本。与1.*版本相比有重大变更，但单元测试、功能测试以及新的工厂非常易于使用。

版本 1.*

如果你已安装旧版本并且愿意使用，你可以在标签v1.0.6中找到文档和文件，浏览代码。

需要注意的事情

CSV更快，所以如果你需要创建简单的xls文件，我鼓励你使用内置的csv功能：https://php.ac.cn/manual-lookup.php?pattern=csv&lang=en&scope=quickref

安装

1 将以下内容添加到composer.json的require键

    $composer require liuggio/excelbundle

2 在`app/AppKernel.php中注册Bundle

    $bundles = array(
        // ...
        new Liuggio\ExcelBundle\LiuggioExcelBundle(),
    );

TL;DR

• 创建一个空对象

$phpExcelObject = $this->get('Liuggio\ExcelBundle\Factory')->createPHPExcelObject();

• 从一个文件创建对象

$phpExcelObject = $this->get('Liuggio\ExcelBundle\Factoryl')->createPHPExcelObject('file.xls');

• 从对象创建Excel5并写入文件

$writer = $this->get('Liuggio\ExcelBundle\Factory')->createWriter($phpExcelObject, 'Excel5');
$writer->save('file.xls');

• 从对象创建Excel5并创建StreamedResponse

$writer = $this->get('Liuggio\ExcelBundle\Factory')->createWriter($phpExcelObject, 'Excel5');
$response = $this->get('Liuggio\ExcelBundle\Factory')->createStreamedResponse($writer);

• 创建带有图片的Excel文件

$writer = $this->get('Liuggio\ExcelBundle\Factory')->createPHPExcelObject();
$writer->setActiveSheetIndex(0);
$activesheet = $writer->getActiveSheet();

$drawingobject = $this->get('Liuggio\ExcelBundle\Factory')->createPHPExcelWorksheetDrawing();
$drawingobject->setName('Image name');
$drawingobject->setDescription('Image description');
$drawingobject->setPath('/path/to/image');
$drawingobject->setHeight(60);
$drawingobject->setOffsetY(20);
$drawingobject->setCoordinates('A1');
$drawingobject->setWorksheet($activesheet)

注意：建议注入工厂而不是从容器中获取

不仅仅是'Excel5'

类型列表如下

1. 'Excel5'
2. 'Excel2007'
3. 'Excel2003XML'
4. 'OOCalc'
5. 'SYLK'
6. 'Gnumeric'
7. 'HTML'
8. 'CSV'

示例

模拟控制器

最佳起点是位于Tests/app/Controller/FakeController.php的模拟控制器，这是一个工作示例。

更多示例

你可以在官方PHPExcel仓库中找到很多示例：https://github.com/PHPOffice/PHPExcel/tree/develop/Examples

对于懒惰的开发者

namespace YOURNAME\YOURBUNDLE\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\ResponseHeaderBag;

class DefaultController extends Controller
{

    public function indexAction($name)
    {
        // ask the service for a Excel5
       $phpExcelObject = $this->get('Liuggio\ExcelBundle\Factory')->createPHPExcelObject();
       // or inject it: $phpExcelObject = $injectedExcelFactory->createPHPExcelObject();

       $phpExcelObject->getProperties()->setCreator("liuggio")
           ->setLastModifiedBy("Giulio De Donato")
           ->setTitle("Office 2005 XLSX Test Document")
           ->setSubject("Office 2005 XLSX Test Document")
           ->setDescription("Test document for Office 2005 XLSX, generated using PHP classes.")
           ->setKeywords("office 2005 openxml php")
           ->setCategory("Test result file");
       $phpExcelObject->setActiveSheetIndex(0)
           ->setCellValue('A1', 'Hello')
           ->setCellValue('B2', 'world!');
       $phpExcelObject->getActiveSheet()->setTitle('Simple');
       // Set active sheet index to the first sheet, so Excel opens this as the first sheet
       $phpExcelObject->setActiveSheetIndex(0);

        // create the writer
        $writer = $this->get('Liuggio\ExcelBundle\Factory')->createWriter($phpExcelObject, 'Excel5');
        // create the response
        $response = $this->get('Liuggio\ExcelBundle\Factory')->createStreamedResponse($writer);
        // adding headers
        $dispositionHeader = $response->headers->makeDisposition(
            ResponseHeaderBag::DISPOSITION_ATTACHMENT,
            'stream-file.xls'
        );
        $response->headers->set('Content-Type', 'text/vnd.ms-excel; charset=utf-8');
        $response->headers->set('Pragma', 'public');
        $response->headers->set('Cache-Control', 'maxage=1');
        $response->headers->set('Content-Disposition', $dispositionHeader);

        return $response;        
    }
}

贡献者

贡献者列表：https://github.com/liuggio/ExcelBundle/graphs/contributors

贡献

1. 分叉项目
2. 克隆仓库
3. 获取编码标准修复器：wget http://cs.sensiolabs.org/get/php-cs-fixer.phar
4. 在PullRequest之前，你应该运行编码标准修复器：php php-cs-fixer.phar fix -v .