README

Transformist 是一个 PHP 文件转换库。它提供高级 API，可以轻松地将文件转换为不同的格式。

它还设计得易于扩展，只需添加自定义转换器即可。

示例

以下是如何将目录中的所有 Word 文档转换为 PDF 文件的示例

<?php

$Transformist = new Transformist( );
$Transformist->setup(
	'/path/to/directory',
	'application/msword',
	'application/pdf'
);

if ( $Transformist->run( )) {
	// You're good to go !
}

?>

您可以使用 setup( ) 方法以不同的方式一次性转换多个文档

<?php

// Output directory

$Transformist->setup(
	array( '/path/to/input/directory' => '/path/to/output/directory' ),
	'application/msword',
	'application/pdf'
);


// Conversion of a particular file

$Transformist->setup(
	'/path/to/directory',
	'file.doc',
	'application/pdf'
);


// All files matching a pattern

$Transformist->setup(
	'/path/to/directory',
	'*.doc',
	'application/pdf'
);


// Multiple conversions

$Transformist->setup(
	'/path/to/directory',
	array(
		'*.doc'     => 'application/pdf',
		'image/jpg' => 'image/png'
	)
);

?>

可用的转换

在继续之前，您可能想了解 Transformist 可以处理哪些转换。为此有一个方法

<?php

$conversions = $Transformist->availableConversions( );

?>

此方法返回一个所有可能转换的数组。它的每个键代表一个输入类型，并指向一个输出类型的数组。

通常，它看起来像这样

<?php

array(
	'image/jpeg' => array(
		'image/png'
	),
	'image/png' => array(
		'image/tiff'
	)
);

?>

在这里，您可以转换 JPG 图像到 PNG，以及 PNG 图像到 TIFF。

测试

Transformist 提供了一种检查所有转换器有效性的方法。一些可以在没有进一步配置的情况下运行，而其他一些则可能依赖于外部库，必须安装这些库才能使转换器工作。

<?php

$results = $Transformist->testConverters( );

// Or statically:

$results = Transformist::testConverters( );

?>

$results 现在看起来像这样

<?php

array(
	'Transformist_Converter_Office_Pdf' => true,
	'Transformist_Converter_Office_Png' => 'An external library is missing!',
	'Transformist_Converter_Office_Tiff' => true
);

?>

您应该在配置系统或排除错误时仅运行此函数一次，因为某些转换器可能需要进行一些重计算以测试其环境。