English
资源说明：git svn clone of http://svn.symfony-project.com/plugins/sfTCPDFPlugin
sfTCPDFPlugin
-------------
The **sfTCPDFPlugin** plugin provides abstraction for the [TCPDF library](http://www.tecnick.com/public/code/cp_dpage.php?aiocp_dp=tcpdf).
The main interest of this [FPDF](http://www.fpdf.org/) "fork" resides in the fact
that it can handle any UTF8 strings witch is the native encoding format used by symfony.
It also provides a handy config handler to manage several configurations
with a YAML file, so you don't have to set the TCPDF constants.
Installation
============
* Install the plugin
$ symfony plugin:install sfTCPDFPlugin
(or download it and unzip in your `/plugins` directory)
* You can also checkout the svn repository or make an `svn:external`:
* [symfony 1.0.x](http://svn.symfony-project.com/plugins/sfTCPDFPlugin/branches/1.0/)
* [symfony 1.2.x, 1.3.x, 1.4.x](http://svn.symfony-project.com/plugins/sfTCPDFPlugin/branches/1.2/)
* Download the [TCPDF library](http://sourceforge.net/project/showfiles.php?group_id=128076&package_id=140403)
* Unzip it inside the `/plugins/sfTCPDFplugin/lib` folder, at this point, you
should have a `tcpdf` folder in `/plugins/sfTCPDFPlugin/lib` (this folder is set as ignored by `svn`)
* Publish the assets of the plugin (this is only useful if you want to test the demos included in the plugin)
$ symfony plugin:publish-assets
* Clear you cache
$ symfony cc
Configuration
=============
The plugin comes with a *default* configuration, but you will surely want to add some:
* Copy the `/plugins/sfTCPDFPlugin/config/pdf_configs.yml` into the `config` folder
of your application. Then this file will be used.
* Now, you can add your own configurations. You should keep the `default` one witch
is the basic configuration provided by TCPDF.
>**Note**
>Note that you don't have to modify the parameters in the `# Auto-detected` section,
>because the config handler of the plugin will set these values for you. But if
>you set a value for one of these parmeters, the plugin will not override it.
# Main config, check the '/tcpdf/config/tcpdf_config.file' and the TCPDF documentation
# for more infos about these parameters
default:
# Be carefull the order of these configuration keys should not be modified.
# Disable default TCPDF default config
K_TCPDF_EXTERNAL_CONFIG: true
# Auto-detected parameters (leave empty for auto-detection) ##################
K_PATH_MAIN:
K_PATH_URL:
K_PATH_FONTS:
K_PATH_CACHE:
K_PATH_URL_CACHE:
K_PATH_IMAGES:
K_BLANK_IMAGE:
# Other parameters ##########################################################
# page format
PDF_PAGE_FORMAT: "A4"
# page orientation (P=portrait, L=landscape)
PDF_PAGE_ORIENTATION: "P"
# document creator
PDF_CREATOR: "TCPDF"
# document author
PDF_AUTHOR: "TCPDF"
# header title
PDF_HEADER_TITLE: "TCPDF Example"
# header description string
PDF_HEADER_STRING: "by Nicola Asuni - Tecnick.com\nwww.tcpdf.org - symfony1 plugin by Vernet Loïc (Aka COil) - http://www.symfony-project.org/plugins/sfTCPDFPlugin"
# image logo
PDF_HEADER_LOGO: "tcpdf_logo.jpg"
# header logo image width [mm]
PDF_HEADER_LOGO_WIDTH: 30
# document unit of measure [pt=point, mm=millimeter, cm=centimeter, in=inch]
PDF_UNIT: "mm"
# header margin
PDF_MARGIN_HEADER: "5"
# footer margin
PDF_MARGIN_FOOTER: "10"
# top margin
PDF_MARGIN_TOP: "27"
# bottom margin
PDF_MARGIN_BOTTOM: "25"
# left margin
PDF_MARGIN_LEFT: "15"
# right margin
PDF_MARGIN_RIGHT: "15"
# default main font name
PDF_FONT_NAME_MAIN: "helvetica"
# default main font size
PDF_FONT_SIZE_MAIN: "10"
# default data font name
PDF_FONT_NAME_DATA: "helvetica"
# default data font size
PDF_FONT_SIZE_DATA: "8"
# default monospaced font name
PDF_FONT_MONOSPACED: "courier"
# Ratio used to scale the images
PDF_IMAGE_SCALE_RATIO: "4"
# magnification factor for titles
HEAD_MAGNIFICATION: "1.1"
# height of cell repect font height
K_CELL_HEIGHT_RATIO: "1.25"
# title magnification respect main font size
K_TITLE_MAGNIFICATION: "1.3"
# reduction factor for small font
K_SMALL_RATIO: "2/3"
# set to true to enable the special procedure used to avoid the overlappind of symbols on Thai language
K_THAI_TOPCHARS: true
# if true allows to call TCPDF methods using HTML syntax
# IMPORTANT: For security reason, disable this feature if you are printing user HTML content.
K_TCPDF_CALLS_IN_HTML: true
>**Note**
>Check the [TCPDF documentation](http://www.tcpdf.org/docs.php)
>to have more informations about all this parameters.
Usage
=====
To load a config defined in your YAML just use the following helper:
[php]
$config = sfTCPDFPluginConfigHandler::loadConfig('my_config');
Where `my_config` is the config key name defined in your YAML file. (like above)
>**Note**
>If you don't pass a config to the config helper the `default` config will be user
>(like below)
* 1 - **Hello World test** (sfTCPDF/test)
[php]
/**
* Hello world test.
*/
public function executeTest()
{
$config = sfTCPDFPluginConfigHandler::loadConfig();
// pdf object
$pdf = new sfTCPDF();
// set document information
$pdf->SetCreator(PDF_CREATOR);
$pdf->SetAuthor('Nicola Asuni');
$pdf->SetTitle('TCPDF Example 001');
$pdf->SetSubject('TCPDF Tutorial');
$pdf->SetKeywords('TCPDF, PDF, example, test, guide');
// set default header data
$pdf->SetHeaderData(PDF_HEADER_LOGO, PDF_HEADER_LOGO_WIDTH, PDF_HEADER_TITLE.' 001', PDF_HEADER_STRING);
// set header and footer fonts
$pdf->setHeaderFont(Array(PDF_FONT_NAME_MAIN, '', PDF_FONT_SIZE_MAIN));
$pdf->setFooterFont(Array(PDF_FONT_NAME_DATA, '', PDF_FONT_SIZE_DATA));
// set default monospaced font
$pdf->SetDefaultMonospacedFont(PDF_FONT_MONOSPACED);
//set margins
$pdf->SetMargins(PDF_MARGIN_LEFT, PDF_MARGIN_TOP, PDF_MARGIN_RIGHT);
$pdf->SetHeaderMargin(PDF_MARGIN_HEADER);
$pdf->SetFooterMargin(PDF_MARGIN_FOOTER);
//set auto page breaks
$pdf->SetAutoPageBreak(TRUE, PDF_MARGIN_BOTTOM);
//set image scale factor
$pdf->setImageScale(PDF_IMAGE_SCALE_RATIO);
// ---------------------------------------------------------
// set default font subsetting mode
$pdf->setFontSubsetting(true);
// Set font
// dejavusans is a UTF-8 Unicode font, if you only need to
// print standard ASCII chars, you can use core fonts like
// helvetica or times to reduce file size.
$pdf->SetFont('dejavusans', '', 14, '', true);
// Add a page
// This method has several options, check the source code documentation for more information.
$pdf->AddPage();
// Set some content to print
$html = <<Welcome to TCPDF and the sfTCPDF symfony1 plugin!
This is the first example of TCPDF library.
I can handle UTF8: €àèéìòù
This text is printed using the writeHTMLCell() method but you can also use: Multicell(), writeHTML(), Write(), Cell() and Text().
Please check the source code documentation and other examples for further information.
TO IMPROVE AND EXPAND TCPDF I NEED YOUR SUPPORT, PLEASE MAKE A DONATION!
EOD;
// Print text using writeHTMLCell()
$pdf->writeHTMLCell($w=0, $h=0, $x='', $y='', $html, $border=0, $ln=1, $fill=0, $reseth=true, $align='', $autopadding=true);
// ---------------------------------------------------------
// Close and output PDF document
// This method has several options, check the source code documentation for more information.
$pdf->Output('example_001.pdf', 'I');
// Stop symfony process
throw new sfStopException();
}
* 2 - **Full test** (sfTCPDF/test2)
[php]
/**
* Full test.
*/
public function executeTest2()
{
$config = sfTCPDFPluginConfigHandler::loadConfig();
sfTCPDFPluginConfigHandler::includeLangFile($this->getUser()->getCulture());
$doc_title = "test title";
$doc_subject = "test description";
$doc_keywords = "test keywords";
$htmlcontent = "< € €àèéìòù © >
heading 1
heading 2
heading 3
heading 4
heading 5
heading 6
ordered list:
- bold text
- italic text
- underlined text
- link to http://www.tecnick.com
- test break
second line
third line - font + 3
- small text
- normal subscript superscript
table:
# A B 1 A1 B1 2 A2 € € € & è è B2 3 A3 B3
image:
![\"test](\"sfTCPDFPlugin/images/logo_example.png\")
";
//create new PDF document (document units are set by default to millimeters)
$pdf = new sfTCPDF(PDF_PAGE_ORIENTATION, PDF_UNIT, PDF_PAGE_FORMAT, true);
// set document information
$pdf->SetCreator(PDF_CREATOR);
$pdf->SetAuthor(PDF_AUTHOR);
$pdf->SetTitle($doc_title);
$pdf->SetSubject($doc_subject);
$pdf->SetKeywords($doc_keywords);
$pdf->SetHeaderData(PDF_HEADER_LOGO, PDF_HEADER_LOGO_WIDTH, PDF_HEADER_TITLE, PDF_HEADER_STRING);
//set margins
$pdf->SetMargins(PDF_MARGIN_LEFT, PDF_MARGIN_TOP, PDF_MARGIN_RIGHT);
//set auto page breaks
$pdf->SetAutoPageBreak(TRUE, PDF_MARGIN_BOTTOM);
$pdf->SetHeaderMargin(PDF_MARGIN_HEADER);
$pdf->SetFooterMargin(PDF_MARGIN_FOOTER);
$pdf->setImageScale(PDF_IMAGE_SCALE_RATIO); //set image scale factor
$pdf->setHeaderFont(Array(PDF_FONT_NAME_MAIN, '', PDF_FONT_SIZE_MAIN));
$pdf->setFooterFont(Array(PDF_FONT_NAME_DATA, '', PDF_FONT_SIZE_DATA));
//initialize document
$pdf->AliasNbPages();
$pdf->AddPage();
// set barcode
$pdf->SetBarcode(date("Y-m-d H:i:s", time()));
// output some HTML code
$pdf->writeHTML($htmlcontent , true, 0);
// output two html columns
$first_column_width = 80;
$current_y_position = $pdf->getY();
$pdf->writeHTMLCell($first_column_width, 0, 0, $current_y_position, "hello", 0, 0, 0);
$pdf->writeHTMLCell(0, 0, $first_column_width, $current_y_position, "world", 0, 1, 0);
// output some content
$pdf->Cell(0,10,"TEST Bold-Italic Cell",1,1,'C');
// output some UTF-8 test content
$pdf->AddPage();
$pdf->SetFont("FreeSerif", "", 12);
$utf8text = file_get_contents(K_PATH_CACHE. "utf8test.txt", false); // get utf-8 text form file
$pdf->SetFillColor(230, 240, 255, true);
$pdf->Write(5,$utf8text, '', 1);
// remove page header/footer
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// Two HTML columns test
$pdf->AddPage();
$right_column = "right column right column right column right column right column
right column right column right column right column right column right column
right column right column right column right column right column right column";
$left_column = "left column left column left column left column left column left
column left column left column left column left column left column left column
left column left column left column left column left column left column left
column";
$first_column_width = 80;
$second_column_width = 80;
$column_space = 20;
$current_y_position = $pdf->getY();
$pdf->writeHTMLCell($first_column_width, 0, 0, 0, $left_column, 1, 0, 0);
$pdf->Cell(0);
$pdf->writeHTMLCell($second_column_width, 0, $first_column_width+$column_space, $current_y_position, $right_column, 0, 0, 0);
// add page header/footer
$pdf->setPrintHeader(true);
$pdf->setPrintFooter(true);
$pdf->AddPage();
// Multicell test
$pdf->MultiCell(40, 5, "A test multicell line 1\ntest multicell line 2\ntest multicell line 3", 1, 'J', 0, 0);
$pdf->MultiCell(40, 5, "B test multicell line 1\ntest multicell line 2\ntest multicell line 3", 1, 'J', 0);
$pdf->MultiCell(40, 5, "C test multicell line 1\ntest multicell line 2\ntest multicell line 3", 1, 'J', 0, 0);
$pdf->MultiCell(40, 5, "D test multicell line 1\ntest multicell line 2\ntest multicell line 3", 1, 'J', 0, 2);
$pdf->MultiCell(40, 5, "F test multicell line 1\ntest multicell line 2\ntest multicell line 3", 1, 'J', 0);
// Close and output PDF document
$pdf->Output();
// Stop symfony process
throw new sfStopException();
}
Demo
====
If you want to run the tests, enable the `sfTCPDF` module in your `settings.yml`
file, then call `sfTCPDF/test` or `sfTCPDF/test2`. (If you have desactivated the
default symfony routes, a `routing.yml` file is included in the `config` folder
of the plugin.
You can also check the online demos on my blog:
* [Basic example](http://snippets.strangebuzz.com/sfTCPDF/test)
* [Advanced example](http://snippets.strangebuzz.com/sfTCPDF/test2)
>**Note**
>It seems there are problems with the TCPDF class when using PHP 5.1.x under windows.
TODO
====
* ?
Changelog
=========
>**Note**
>Check the changelog TAB of the plugin homepage
Support
=======
Please send me an email or report bugs on the symfony TRAC, I could also answer
if you ask on the symfony1 mailing list.
----
See you. [COil](http://www.strangebuzz.com) :)
----
This plugin is sponsored by [SQL-Technologies](http://www.sqltechnologies.com)
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
