Skip to content

Knowledgebase

Enabling the Mailparse extension with CloudLinux in DirectAdmin

control-panels, development

Mailparse helps PHP software inspect MIME email messages and attachments. A helpdesk, mail importer or custom application may require it even when ordinary website mail sending already works. It does not create a mailbox, configure SMTP or repair DNS authentication records.

Check access and requirements

Check the application's current dependency list and identify the runtime used by its mail-import process. A browser request, cron job and background worker may use different PHP executables. Keep a sample message that contains no confidential customer information for testing.

01 Change the setting

  1. In DirectAdmin, open the appropriate user account and domain, then search for Select PHP Version. In Evolution it may appear under Extra Features. Open the CloudLinux selector, not an unrelated server administration page.
  2. Check the active PHP version and which websites the selector change will affect. DirectAdmin can expose both its native PHP selection and CloudLinux PHP Selector. The selected domain in DirectAdmin does not by itself prove that an Alt-PHP change is isolated to that domain. Check the selector scope before applying an account-wide change.
  3. Open Extensions for the active PHP version and locate mailparse.
  4. Enable it and save if required. Mailparse requires mbstring to be loaded before it, so confirm that dependency is enabled in the same runtime. Ask support to correct a package or load-order problem; the selector only offers extensions installed by the server administrator.
  5. Run the application's dependency check and import a small test message with a harmless attachment. Verify the scheduled importer separately if it runs through cron.

Confirm the expected result

Confirm that the application reports the extension available and correctly separates the message sender, subject, body and attachment. Check character encoding with a representative multilingual message if your helpdesk handles multiple languages.

What should I check if the application still reports Mailparse as missing?

If the browser reports success but cron still fails, compare the cron PHP path and loaded extensions. If an extension is unavailable for the selected version, ask support for the supported combination. Do not paste real customer messages or mailbox credentials into a public diagnostic page.

Was this answer helpful?

Need a little more help?

Our support team can help you find the next step.

Contact support