Pixeldust Drupal Support Service

Filesystem "Invalid filename" error when copying a file with special UTF-8 characters

Today, when I was re-enabling a custom migration module again after a few months, it stopped working because a few files contain special german characters like äöüÄÖÜß. I haven’t changed anything in my code, but I updated Drupal from 9.1 to 9.3 recently.

In my module, I scan a directory for its files in the module’s directory and then copy these files to the site’s public file directory. When logging error messages, it seems like the filesystem isn’t able to understand the file’s names correctly: Invalid filename 'df▒d93.JPG'. The file’s correct name is dföd93.JPG.

The function Drupal::service('file_system')->copy($file->uri, $path . $file->filename, FileSystemInterface::EXISTS_REPLACE); makes a check if the file name is valid UTF-8 (Unicode::validateUtf8()), so for the filename with the ▒ character, it throws an error.

But I think the problem might lie at the scanDirectory() function which returns the wrong file names in the first place:

Drupal::service('file_system')->scanDirectory($dirname, '/.*/', [     'recurse' => TRUE,     'key' => 'uri',   ]);

Has anybody experienced the same problem? Any help is appreciated.

This article was republished from its original source.
Call Us: 1(800)730-2416

Pixeldust is a 20-year-old web development agency specializing in Drupal and WordPress and working with clients all over the country. With our best in class capabilities, we work with small businesses and fortune 500 companies alike. Give us a call at 1(800)730-2416 and let’s talk about your project.

Let's Talk About a Project

FREE Drupal SEO Audit

Test your site below to see which issues need to be fixed. We will fix them and optimize your Drupal site 100% for Google and Bing. (Allow 30-60 seconds to gather data.)

Powered by

Filesystem "Invalid filename" error when copying a file with special UTF-8 characters

On-Site Drupal SEO Master Setup

We make sure your site is 100% optimized (and stays that way) for the best SEO results.

With Pixeldust On-site (or On-page) SEO we make changes to your site’s structure and performance to make it easier for search engines to see and understand your site’s content. Search engines use algorithms to rank sites by degrees of relevance. Our on-site optimization ensures your site is configured to provide information in a way that meets Google and Bing standards for optimal indexing.

This service includes:

  • Pathauto install and configuration for SEO-friendly URLs.
  • Meta Tags install and configuration with dynamic tokens for meta titles and descriptions for all content types.
  • Install and fix all issues on the SEO checklist module.
  • Install and configure XML sitemap module and submit sitemaps.
  • Install and configure Google Analytics Module.
  • Install and configure Yoast.
  • Install and configure the Advanced Aggregation module to improve performance by minifying and merging CSS and JS.
  • Install and configure Schema.org Metatag.
  • Configure robots.txt.
  • Google Search Console setup snd configuration.
  • Find & Fix H1 tags.
  • Find and fix duplicate/missing meta descriptions.
  • Find and fix duplicate title tags.
  • Improve title, meta tags, and site descriptions.
  • Optimize images for better search engine optimization. Automate where possible.
  • Find and fix the missing alt and title tag for all images. Automate where possible.
  • The project takes 1 week to complete.
MASTER YOUR DRUPAL SEO
Pixeldust and Pantheon Drupal Development
256