# Determinar o Formato Original da Apresentação em PHP > Leia o formato original de uma apresentação carregada em PHP com Aspose.Slides para PHP via Java, compare APIs de detecção e manipule arquivos, streams e formatos legados. Source: https://docs.aspose.com/slides/pt/php-java/detect-presentation-source-format/ Updated: 2026-09-22 ## **Visão geral** Depois de carregar uma apresentação, chame o método [Presentation::getSourceFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/presentation/#getSourceFormat) para determinar seu formato original. Use‑o quando o processamento subsequente depender do formato a partir do qual a instância atual foi carregada. O formato de origem é distinto do [SaveFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/saveformat/) selecionado para um arquivo de saída. Salvar em outro formato não altera o formato de origem da instância existente. ## **Ler o Formato de Origem de um Arquivo** Este exemplo requer um arquivo `sample.pptx` existente. Ele carrega o arquivo e seleciona uma política de processamento da aplicação usando [Presentation::getSourceFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/presentation/#getSourceFormat), em vez do nome do arquivo. Altere o caminho de entrada para experimentar outros formatos. O exemplo imprime a política selecionada; substitua as mensagens pela lógica da sua aplicação. ```php use aspose\slides\Presentation; use aspose\slides\SourceFormat; $presentation = new Presentation("sample.pptx"); try { switch (java_values($presentation->getSourceFormat())) { case SourceFormat::Ppt: case SourceFormat::Pps: case SourceFormat::Pot: echo "Use the legacy PowerPoint processing policy." . PHP_EOL; break; case SourceFormat::Pptx: echo "Use the standard PPTX processing policy." . PHP_EOL; break; default: echo "Use the general policy for source format " . java_values($presentation->getSourceFormat()) . "." . PHP_EOL; break; } } finally { $presentation->dispose(); } ``` ## **Reconhecer os Valores Compatíveis** A classe [SourceFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/sourceformat/) define constantes inteiras que distinguem os seguintes formatos de apresentação. As extensões abaixo são extensões convencionais, não uma reconstrução do nome de arquivo original. | Valor SourceFormat | Extensão | Formato | | --- | --- | --- | | `Ppt` | `.ppt` | Apresentação PowerPoint 97–2003 | | `Pptx` | `.pptx` | Apresentação Office Open XML | | `Pptm` | `.pptm` | Apresentação Office Open XML com macros | | `Pps` | `.pps` | Apresentação de slides PowerPoint 97–2003 | | `Ppsx` | `.ppsx` | Apresentação de slides Office Open XML | | `Ppsm` | `.ppsm` | Apresentação de slides Office Open XML com macros | | `Pot` | `.pot` | Modelo PowerPoint 97–2003 | | `Potx` | `.potx` | Modelo Office Open XML | | `Potm` | `.potm` | Modelo Office Open XML com macros | | `Odp` | `.odp` | Apresentação OpenDocument | | `Otp` | `.otp` | Modelo de apresentação OpenDocument | | `Fodp` | `.fodp` | Apresentação ODF Flat XML | | `Xml` | `.xml` | Apresentação PowerPoint XML | ## **Ler o Formato de Origem de um Stream** Este exemplo requer um arquivo `sample.pps` existente. Ler seus bytes em um stream de memória modela a entrada recebida sem um nome de arquivo, como um valor de banco de dados ou um array de bytes enviado. O construtor [Presentation](https://reference.aspose.com/slides/pt/php-java/aspose.slides/presentation/) recebe apenas o stream. ```php use aspose\slides\Presentation; $inputFile = new Java("java.io.File", "sample.pps"); $bytes = java("java.nio.file.Files")->readAllBytes($inputFile->toPath()); $stream = new Java("java.io.ByteArrayInputStream", $bytes); try { $presentation = new Presentation($stream); try { echo "Source format: " . java_values($presentation->getSourceFormat()) . PHP_EOL; } finally { $presentation->dispose(); } } finally { $stream->close(); } ``` PPT, PPS e POT utilizam o mesmo formato binário subjacente. Ao carregar por caminho de arquivo, a extensão pode ajudar a distinguir uma apresentação de slides ou um modelo. Sem um nome de arquivo, o conteúdo legado de PPS e POT pode ser relatado como `SourceFormat::Ppt`; o exemplo de PPS acima imprime o valor inteiro de `SourceFormat::Ppt`. Se sua aplicação precisar preservar a distinção, mantenha o nome de arquivo original ou os metadados de subtipo separadamente. Uma extensão é uma dica útil para esses subtipos legados, mas não deve ser a única base para identificar conteúdo de apresentação arbitrário. ## **Comparar a Detecção Antes e Depois do Carregamento** Use [PresentationFactory::getPresentationInfo](https://reference.aspose.com/slides/pt/php-java/aspose.slides/presentationfactory/#getPresentationInfo) e [PresentationInfo::getLoadFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/presentationinfo/#getLoadFormat) quando precisar inspecionar um arquivo antes de carregar seu modelo de objeto de apresentação completo. Use [Presentation::getSourceFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/presentation/#getSourceFormat) quando a instância já existir. Este exemplo requer `sample.pptx` e imprime os valores inteiros de `LoadFormat::Pptx` e `SourceFormat::Pptx`, respectivamente. Em produção, escolha a API apropriada para sua fase de processamento; uma apresentação já carregada não precisa de uma segunda inspeção apenas para obter seu formato de origem. ```php use aspose\slides\Presentation; use aspose\slides\PresentationFactory; $path = "sample.pptx"; $information = PresentationFactory::getInstance()->getPresentationInfo($path); echo "Before loading: " . java_values($information->getLoadFormat()) . PHP_EOL; $presentation = new Presentation($path); try { echo "After loading: " . java_values($presentation->getSourceFormat()) . PHP_EOL; } finally { $presentation->dispose(); } ``` Os resultados utilizam constantes de classes diferentes: [LoadFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/loadformat/) e [SourceFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/sourceformat/). Não compare seus valores numéricos nem presuma que todo formato tem resultados de detecção idênticos. O PowerPoint XML pode ser relatado como `LoadFormat::Unknown` antes do carregamento e `SourceFormat::Xml` após o carregamento. ## **Manter Formatos de Origem e Saída Separados** Este exemplo requer `sample.pptx` e grava `converted.odp`. Ele imprime o valor inteiro de `SourceFormat::Pptx` tanto antes quanto depois de salvar a instância original. Apenas a nova instância carregada a partir da saída ODP relata `Odp`. ```php use aspose\slides\Presentation; use aspose\slides\SaveFormat; $presentation = new Presentation("sample.pptx"); try { echo "Before saving: " . java_values($presentation->getSourceFormat()) . PHP_EOL; $presentation->save("converted.odp", SaveFormat::Odp); echo "After saving: " . java_values($presentation->getSourceFormat()) . PHP_EOL; $reopened = new Presentation("converted.odp"); try { echo "Reopened output: " . java_values($reopened->getSourceFormat()) . PHP_EOL; } finally { $reopened->dispose(); } } finally { $presentation->dispose(); } ``` Uma apresentação criada do zero com `new Presentation()` relata `SourceFormat::Pptx`. Ela não possui arquivo de entrada: este é o valor padrão para uma instância recém‑criada, não prova que um arquivo PPTX foi carregado. Controle separadamente se sua aplicação criou ou carregou a instância, se essa distinção for importante. ## **Mapear um Formato de Origem para uma Extensão** O exemplo a seguir requer `sample.pptx`. Ele mapeia cada valor atualmente suportado de [SourceFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/sourceformat/) para uma extensão convencional, sem analisar o nome de arquivo de entrada. O fallback evita atribuir silenciosamente uma extensão a um valor não reconhecido. ```php use aspose\slides\Presentation; use aspose\slides\SourceFormat; $presentation = new Presentation("sample.pptx"); try { $extension = null; switch (java_values($presentation->getSourceFormat())) { case SourceFormat::Ppt: $extension = ".ppt"; break; case SourceFormat::Pptx: $extension = ".pptx"; break; case SourceFormat::Pptm: $extension = ".pptm"; break; case SourceFormat::Pps: $extension = ".pps"; break; case SourceFormat::Ppsx: $extension = ".ppsx"; break; case SourceFormat::Ppsm: $extension = ".ppsm"; break; case SourceFormat::Pot: $extension = ".pot"; break; case SourceFormat::Potx: $extension = ".potx"; break; case SourceFormat::Potm: $extension = ".potm"; break; case SourceFormat::Odp: $extension = ".odp"; break; case SourceFormat::Otp: $extension = ".otp"; break; case SourceFormat::Fodp: $extension = ".fodp"; break; case SourceFormat::Xml: $extension = ".xml"; break; default: $extension = null; break; } echo ($extension !== null ? $extension : "No extension mapping is available.") . PHP_EOL; } finally { $presentation->dispose(); } ``` Este mapeamento não converte um arquivo nem recupera um subtipo legado PPS/POT perdido durante o carregamento do stream. Para salvar efetivamente, selecione explicitamente um [SaveFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/saveformat/) ou use a conversão mostrada em [Save Presentations in Their Original Format](/slides/pt/php-java/save-presentation/#save-presentations-in-their-original-format). ## **Verificar Formatos Salvando e Reabrindo** Este exemplo autônomo cria uma apresentação e grava três arquivos no diretório de trabalho, sobrescrevendo arquivos com os mesmos nomes. Ele reabre cada saída tanto por caminho quanto através de um stream de memória. Para PPTX e ODP, ambas as rotas relatam o formato salvo. Para PPS, o carregamento por caminho relata `Pps`, enquanto o carregamento dos mesmos bytes sem um nome de arquivo relata `Ppt`. ```php use aspose\slides\Presentation; use aspose\slides\SaveFormat; $presentation = new Presentation(); try { $formats = [SaveFormat::Pptx, SaveFormat::Odp, SaveFormat::Pps]; $extensions = ["pptx", "odp", "pps"]; foreach ($formats as $index => $format) { $path = "roundtrip." . $extensions[$index]; $presentation->save($path, $format); $fromFile = new Presentation($path); try { $inputFile = new Java("java.io.File", $path); $bytes = java("java.nio.file.Files")->readAllBytes($inputFile->toPath()); $stream = new Java("java.io.ByteArrayInputStream", $bytes); try { $fromStream = new Presentation($stream); try { echo $extensions[$index] . ": file=" . java_values($fromFile->getSourceFormat()) . ", stream=" . java_values($fromStream->getSourceFormat()) . PHP_EOL; } finally { $fromStream->dispose(); } } finally { $stream->close(); } } finally { $fromFile->dispose(); } } } finally { $presentation->dispose(); } ``` A tabela a seguir resume a identificação do formato de origem para apresentações com extensões correspondentes. Os nomes denotam constantes; os exemplos em PHP imprimem seus valores inteiros: | Formato salvo | SourceFormat a partir de um caminho de arquivo | SourceFormat a partir de um stream sem nome | | --- | --- | --- | | PPT | `Ppt` | `Ppt` | | PPTX, PPTM | `Pptx`, `Pptm` respectivamente | Mesmo que o caminho do arquivo | | PPS | `Pps` | `Ppt` | | PPSX, PPSM | `Ppsx`, `Ppsm` respectivamente | Mesmo que o caminho do arquivo | | POT | `Pot` | `Ppt` | | POTX, POTM | `Potx`, `Potm` respectivamente | Mesmo que o caminho do arquivo | | ODP, OTP | `Odp`, `Otp` respectivamente | Mesmo que o caminho do arquivo | | FODP | `Fodp` | `Fodp` | | PowerPoint XML | `Xml` | `Xml` | O conteúdo PPS/POT é identificado como `Ppt` para streams sem nome. A tabela descreve a identificação de formato, não a preservação de todos os recursos da apresentação durante a conversão. ## **Perguntas Frequentes** **Salvar em ODP altera o formato de origem de uma apresentação carregada de PPTX?** Não. A instância existente ainda relata `Pptx`. Uma instância carregada a partir do arquivo ODP salvo relata `Odp`. **Um stream pode sempre distinguir uma apresentação legada, um slide show e um modelo?** Não. PPT, PPS e POT compartilham o formato binário. Mantenha o nome de arquivo ou os metadados de subtipo separadamente quando essa distinção for necessária. **Qual API devo usar se a apresentação já estiver carregada?** Leia [Presentation::getSourceFormat](https://reference.aspose.com/slides/pt/php-java/aspose.slides/presentation/#getSourceFormat). Use [PresentationFactory::getPresentationInfo](https://reference.aspose.com/slides/pt/php-java/aspose.slides/presentationfactory/#getPresentationInfo) para inspeção antes do carregamento.