What should I do if I get an error when uploading pictures with Chinese characters in PHP?

When using PHP to upload files, if the file name contains Chinese characters, the upload may fail. This is because in the HTTP protocol, the Chinese characters in the file name need to be encoded to be transmitted correctly, and PHP does not perform this encoding by default, thus causing the upload to fail.

Now, let’s discuss how to solve this problem.

Performance of the problem

When we use PHP to upload files, if the uploaded file name contains Chinese characters, the upload may report an error. The error message is usually some incomprehensible garbled characters. The cause of the error cannot be pinpointed.

For example, we try to upload a file named "Test Image.jpg". During the upload process, if the file name contains Chinese characters, such as "Test Image (Chinese).jpg", the upload may fail. Failure, the error message is as follows:

Warning: move_uploaded_file(): Unable to move '/tmp/php12efan' to '/var/www/html/upload/测试图片(中文).jpg'

As you can see, the file name in the error message is garbled, and the cause of the error cannot be clearly pointed out.

Cause of the problem

The reason for this problem is that in the HTTP protocol, Chinese characters need to be encoded to be transmitted correctly. When using PHP to upload files, PHP will convert the uploaded file name to the ISO-8859-1 encoding format by default, and Chinese characters are not included in the ISO-8859-1 encoding, so garbled characters will appear.

If we look at the uploaded HTTP request, we can see that the uploaded file name is like this:

Content-Disposition: form-data; name="file"; filename="测试图片(中文).jpg"

You can see that the uploaded file name is not encoded in any way.

Solution

There are many ways to solve this problem. We provide two common solutions here.

Option 1: Manual encoding conversion

We can manually convert the uploaded file name to obtain the correct file name. The specific operation is as follows:

$file = $_FILES['file'];

$filename = iconv('UTF-8', 'ISO-8859-1', $file['name']);

move_uploaded_file($file['tmp_name'], '/var/www/html/upload/' . $filename);

In the above code, we used the iconv function to convert the file name from UTF-8 encoding to ISO-8859-1 encoding, and obtained the correct file name. , and then upload the file. The disadvantage of this method is that it is relatively cumbersome and requires manual encoding conversion, which is not convenient enough.

Option 2: Modify the PHP configuration file

We can modify the PHP configuration file to allow PHP to automatically perform encoding conversion, thus avoiding the process of manual encoding conversion. The specific operations are as follows:

1. Find the php.ini configuration file. The location may vary depending on different systems.

2. Open the php.ini file and find the following two lines:

   ; Default charset for auto content type. 
   ; http://php.net/default-charset 
   default_charset = "UTF-8"

   Copy after login

3. In the line ; Default charset for auto content type. Add the following content after:

   ; Add charset=utf-8 to Content-Type header for files with non-ASCII names
   ; that have been encoded using RFC 2231
   suhosin.upload.unicode.semantics=1

   Copy after login
4. Save the php.ini file and restart the web server.

Through the above operations, we have successfully modified the PHP configuration file, allowing PHP to automatically perform encoding conversion, and solved the problem of errors when uploading images with Chinese characters. This method is more convenient, but it should be noted that before using this method, you need to ensure that the Suhosin extension has been installed on the server.

Summary

When using PHP to upload files, if the uploaded file name contains Chinese characters, you may encounter an upload failure. To solve this problem, you can manually perform encoding conversion, or you can modify the PHP configuration file and let PHP automatically perform encoding conversion. Both methods have their own advantages and disadvantages, and you can choose the appropriate method to solve it according to the actual situation.

The above is the detailed content of What should I do if I get an error when uploading pictures with Chinese characters in PHP?. For more information, please follow other related articles on the PHP Chinese website!