What is MIME type "text/x-perl"?

A MIME type is a string that tells browsers and other tools how to handle a particular kind of file.

The MIME type text/x-perl designates files containing Perl code. It tells applications that the file is a text file meant to be processed as a Perl script. The "x-" prefix indicates it is a non-standard or experimental registration.

It is used for server-side programming, especially in CGI scripts.
It supports module files and libraries in Perl applications.
It is also applied to in-line documentation written in Pod.
It covers both traditional Perl and modern variants like Raku.

This classification helps operating systems, web servers, and editors to treat files appropriately. Files marked with text/x-perl often include those with extensions such as PL, POD, CGI, PM, PLX, PERL, AL, PM6, T, PH, FCGI, 6PL, 6PM, NQP, P6, P6L, P6M, PL6, PSGI, RAKU, and RAKUMOD.

This MIME type enables systems to apply the correct syntax highlighting, execution permissions, and processing rules to the file. It is key for web servers handling dynamic content and for developers working in environments where clear distinction between code and plain text is essential.

Further details are available on the Perl Wikipedia page and the File Extension Database.

Associated file extensions

.pl, .pod, .cgi, .pm, .plx, .perl, .al, .pm6, .t, .ph, .fcgi, .6pl, .6pm, .nqp, .p6, .p6l, .p6m, .pl6, .psgi, .raku, .rakumod

Usage Examples

HTTP Header

When serving content with this MIME type, set the Content-Type header:


    Content-Type: text/x-perl

HTML

In HTML, you can specify the MIME type in various elements:


    <a href="file.dat" type="text/x-perl">Download file</a>

Server-side (Node.js)

Setting the Content-Type header in Node.js:


    const http = require('http');    
    
    http.createServer((req, res) => {    
      res.setHeader('Content-Type', 'text/x-perl');    
      res.end('Content here');    
    }).listen(3000);

Associated file extensions

.pl, .pod, .cgi, .pm, .plx, .perl, .al, .pm6, .t, .ph, .fcgi, .6pl, .6pm, .nqp, .p6, .p6l, .p6m, .pl6, .psgi, .raku, .rakumod

FAQs

Why is my browser downloading the .pl file instead of running it?

This happens when the web server is not configured to execute the script via CGI or FastCGI. Instead of running the code and sending the output, the server delivers the raw source code with the text/x-perl content type. You must configure your server (e.g., Apache or Nginx) to handle the .pl extension as an executable script.

How do I configure Apache to execute text/x-perl files?

You need to enable mod_cgi or mod_cgid and map the extension to the CGI handler. Typically, you add AddHandler cgi-script .pl to your configuration or .htaccess file. Additionally, ensure the script file has execution permissions (e.g., chmod 755 script.pl) on the server file system.

Is text/x-perl a standard IANA MIME type?

No, the x- prefix indicates it is a non-standard or experimental type. While text/x-perl is widely used to identify Perl source code, you may also encounter application/x-perl or application/x-httpd-cgi. Since Perl is text-based, it is often treated similarly to text/plain if no specific handler is defined.

What is the security risk of serving files as text/x-perl?

The primary risk is source code disclosure. If the server fails to execute the script and serves it as text, users can view the source code, which might contain hardcoded database passwords, API keys, or internal logic. Always test server configuration to ensure .cgi and .pl files execute rather than display.

How does Nginx handle Perl scripts?

Nginx cannot execute Perl CGI scripts directly like Apache; it requires an external FastCGI wrapper (such as fcgiwrap). You must configure Nginx to pass requests for text/x-perl files to the FastCGI socket. Without this configuration, Nginx will simply offer the file for download.

What is the difference between .pl and .pm files?

The .pl extension usually denotes a standalone executable script, while .pm stands for "Perl Module," which contains reusable library code. Both are plain text and can be identified as text/x-perl, but web servers are usually configured to block direct web access to .pm files for security reasons.

Does this MIME type apply to Raku (Perl 6)?

Yes, historically text/x-perl has been used for Raku files (extensions like .raku, .p6, or .pm6). However, because Raku is a distinct language from Perl 5, newer environments might treat them as text/plain or use specific experimental types, though text/x-perl remains a common fallback.

General FAQ

What is a MIME type?

A MIME (Multipurpose Internet Mail Extensions) type is a standard that indicates the nature and format of a document, file, or assortment of bytes. MIME types are defined and standardized in IETF's RFC 6838.

MIME types are important because they help browsers and servers understand how to process a file. When a browser receives a file from a server, it uses the MIME type to determine how to display or handle the content, whether it's an image to display, a PDF to open in a viewer, or a video to play.

MIME types consist of a type and a subtype, separated by a slash (e.g., text/html, image/jpeg, application/pdf). Some MIME types also include optional parameters.

How do I find the MIME type for a file?

You can check the file extension or use a file identification tool such as file --mime-type on the command line. Many programming languages also provide libraries to detect MIME types.

Why are multiple MIME types listed for one extension?

Different applications and historical conventions may use alternative MIME identifiers for the same kind of file. Showing them all helps ensure compatibility across systems.