Website Without PHP
English (United Kingdom)GB
  • English (United States)
  • English (United Kingdom)
  • Dutch (Netherlands)
  • Dutch (Belgium)
Menu

.user.ini

.user.ini is a file for directory-level PHP settings in environments that support this configuration.

Read the explanation

Hosting and infrastructure Last updated:

.user.ini is a file for directory-level PHPPHP is a programming language that builds your web pages on the computer that hosts your site, just before they reach the visitor. WordPress runs on it. settings in environments that support this configuration. Your host may mention this file when explaining how a website limit is configured. It is not a universal remedy for PHP errors.

First establish whether your hostingWeb hosting is the service that keeps your website's files on a computer that is always online, so visitors can open your site at any time. uses this configuration method and which specific problem the proposed setting is intended to address.

What is this file for?

The PHP manual for .user.ini describes directory-level files for CGI and FastCGI environments. Only settings with an allowed change mode are recognised. PHP can reread these files periodically, so saving a change does not necessarily make its effect visible immediately.

The main php.ini filephp.ini is the settings file for PHP on your hosting. It sets limits, such as how much memory a script may use, how big an upload may be and if errors show. and a directory-level file therefore have different roles. Treat a local setting as something to verify in the environment serving your website. Finding a file with the expected name does not establish that the value inside it is being applied to the request you care about.

Start with the reason for changing it

Which PHP version does your site report?

We read only what your site already sends in public: the headers and the top of the homepage. No scan, no login.

Suppose a software supplier asks for more memory during an import. Ask which setting is required and which action is failing. The existing explanation of memory_limitmemory_limit is a PHP setting that decides how much memory the code behind one page may use. If it needs more, it stops with an error. helps you understand that request.

Do not raise several unrelated limits just because an example configuration on another website includes them.

Have your maintainer record the value the website currently uses. Note where it was checked and which environment produced the result. Keep your test copy clearly separate from production in the notes.

Otherwise, evidence from a successful test can be mistaken for proof that the change is already active for visitors.

Also ask whether the setting actually needs to change. A failed import may require further investigation before adjusting the environment. Request the observation supporting the proposal and the outcome expected afterwards.

This keeps the configuration change tied to a specific need rather than a general attempt to make an error disappear.

What should you ask your host?

Ask whether directory-level configuration is used for your account and who maintains it. A reference to PHP-FPMPHP-FPM is a helper on your hosting that runs your site's PHP code as a separate job and hands the finished page back to the program that answers visitors. provides context, but still request an answer for your domainA domain name is the address people type to reach your website, such as yourcompany.com. It points visitors to wherever your site is hosted.. You need the route supported by your hosting arrangement, not just a description of a technique available somewhere in PHP.

Next, confirm where the setting belongs. Do not copy a path from a different website without checking. Ask when the effective value can be checked again after saving.

An agreed check time prevents repeated edits while an earlier change is still waiting to be picked up by the relevant environment.

Establish who owns the file. If both a hosting panel and a developer manage settings, ask which procedure applies. Have the host explain how future adjustments should be made and preserved.

Experimenting with competing management routes on a live website is not a useful way to discover the intended process.

How do you test a change?

Use a test environment where the original action can be repeated. Preserve the old value and describe the proposed replacement with its reason. Change one relevant setting, then check both the effective value and the action that previously failed.

Those checks answer different questions and should be recorded separately in the result.

For example, a completed import is more useful functional evidence than an edited configuration file alone. Record which input was used and whether it had the relevant characteristics of the original input. Use test data and avoid accidentally processing real orders, sending customer messages or repeating other business actions during the check.

Agree in advance what happens if the action still fails. The next step should be an investigation of the remaining error, not another unexplained increase in the limit. Keep the timestamp and error message for the Error Hub and for the person responsible for diagnosing the specific failure.

What should you carry into a hosting move?

Ask the new host which configuration method is supported. A file from the previous environment is useful inventory information, not a guarantee that the same settings will take effect elsewhere. Compare the required values and resolve meaningful differences before directing visitors to the replacement environment.

The hosting guides help you locate PHP settings. The status page provides PHP maintenance context. Use both alongside evidence from your account, keeping general explanations separate from the configuration actually observed on your website.

If you plan to update PHP in WordPress, include relevant local settings in the preparation. A useful handover records the old value, the new value, the website checked and the functional result. Ask for help if it remains unclear where the setting is applied or who should maintain it.

Frequently asked questions

Does .user.ini work on every host?

No. Ask which configuration method your host supports for the particular domain.

Does saving prove the setting changed?

No. Check the effective value and repeat the action that motivated the adjustment.

Can every PHP setting go in this file?

No. The permitted change mode determines which settings can be recognised in this type of file.

Share this page

Ask your AI to explain

Opens the chat with a question about this page. An AI answer can differ; the sources above are leading.

This question is sent along: Summarise the confirmed facts on https://websitewithoutphp.com/en-gb/glossary/user-ini/ in 5 short points, with the source per point.

  1. Domain
  2. Check
  3. Result
  4. Report

Which PHP version does your site run?

Enter your domain. We read only what your site already sends in public: the headers and the top of the homepage. No scan, no login.

We keep the domain and the result, never your IP address.