When using AnQiCMS for website content maintenance, images are indispensable visual elements.However, sometimes the image resources are successfully replaced in the background, but the front-end page fails to display the updated image in time, which may confuse you.This is usually not a system failure, but due to the operation of various caching mechanisms.Understanding these mechanisms and mastering the corresponding handling methods can help you efficiently solve this problem.

AnQiCMS image replacement mechanism

It is crucial to understand how AnQiCMS handles image replacement. When you replace an image through the image resource management feature on the backend, one important feature of AnQiCMS isThe URL address of the image usually remains unchanged.This means that even if the content of the image is updated, the image link referenced by the front-end page is still the old link.The system will update the corresponding image file on the server after replacing the image in the background.

In addition, AnQiCMS also provides rich image processing functions.For example, based on the content settings, the system may automatically compress uploaded images, convert them to WebP format, or generate different versions based on the preset thumbnail size.These optimization measures are intended to enhance website performance and user experience, but they may also indirectly affect the immediacy of image updates.

Common reasons why the image is not updated in time

This feature of keeping the image URL unchanged, although it is beneficial for SEO and link stability, may also cause the front-end page to not display the new image immediately. This is usually related to the following types of cache:

  1. Browser cache:This is the most common reason.The user's browser will save the static resources such as images, CSS, and JavaScript that have been accessed on the website locally to speed up page loading.When accessing the same page again, if the image URL does not change, the browser will directly read from the local cache without re-fetching the new image from the server.
  2. CDN Cache:If your website has deployed a content delivery network (CDN) service, the CDN nodes will also cache your website's static resources.When a user requests an image from a CDN node, CDN returns its cached version.Even if the image on your source server has been updated, the CDN node may still provide the old cached version until its cache expires or is manually refreshed.
  3. AnQiCMS System Cache:AnQiCMS itself may also have a caching mechanism, used to cache page data, configuration information, etc., to improve system response speed.Although the image file itself is not directly cached as page content by AnQiCMS, page fragments or indexes related to the image may be cached.
  4. Web server cache:如果您的网站服务器配置了Nginx或Apache等Web服务器，它们也可能有自己的缓存机制（例如Nginx的FastCGI缓存、Proxy缓存等），用于缓存后端服务的响应，包括图片等静态资源的响应。

Ensure the new image is displayed in time

For the different caching mechanisms mentioned above, we need to take corresponding measures to ensure that the AnQiCMS front-end page can update and display new pictures in time.

  1. Clear local browser cache:

    • Hard refresh:In the browser, try using “Ctrl + F5” (Windows/Linux) or “Cmd + Shift + R” (macOS) to perform a hard refresh.This will force the browser to download all resources on the page, not just those from the cache.
    • Manually clear the cache of specific websites:If hard refresh is not effective, you can go to the browser settings, find the 'Clear Browsing Data' or 'Website Data' option, and select to clear the cache images and files of your website.This ensures that the local cache is completely cleared.

  2. Refresh CDN cache:

    • If you have used a CDN service, you need to log in to the management backend of the CDN service provider, find functions such as "cache refresh", "content distribution", or "clear cache".Then, enter the URL of the image you have replaced or the URL of the relevant page to refresh.Some CDNs support refreshing the cache for the entire domain.

  3. Update AnQiCMS system cache:

    • AnQiCMS backend usually provides an 'Update Cache' or 'Clear Cache' entry.Login to the AnQiCMS management background, which can usually be found in the "Update Cache" or "System Settings" options in the left menu.Click this button, the system will clear the internal cache data to ensure that the latest data can be loaded.

  4. Restart or reload the web server (such as Nginx/Apache):

    • For Web server caching, you may need to connect to your server via SSH and execute the corresponding commands to reload or restart the Web server service. For example, for Nginx, you can usesudo systemctl reload nginxorsudo service nginx reloadCommand; for Apache, you can usesudo systemctl reload apache2orsudo service apache2 reloada command.Please ensure that you understand the potential impact before performing such operations, or do so under the guidance of a professional.

**Practice and Precautions

To reduce the problem of pictures not being updated in time and to improve the efficiency of website operation, it is recommended that you develop the following habits:

  • Develop the habit of clearing the cache in a timely manner:After replacing the image or updating other important content in the background, simply click the 'Update Cache' button in the AnQiCMS background and perform the corresponding refresh operation in the CDN background.
  • Configure image optimization options properly:In AnQiCMS's "Content Settings", you can configure whether images are automatically compressed, whether they are converted to WebP, etc.These settings not only help improve the website loading speed, but also allow you to better manage the file status after the image is updated.For example, if you modify the thumbnail size, you can use the "Batch regenerate thumbnails" feature.
  • Use version-controlled image URLs (advanced):Although AnQiCMS default image URL remains unchanged, in some special cases, in order to ensure that nothing is overlooked, you can add a version number or timestamp to the image file name (for example,image-v2.jpgorimage-20231026.jpg），or by adding a query string to the image URL (for exampleimage.jpg?v=20231026）。So each time the image is updated, the URL will also change, forcing all caching mechanisms to retrieve the new image. However, this requires more complex templates and resource management coordination.
  • Verify on different devices or in stealth mode:After replacing the image, in addition to checking in commonly used browsers, it is best to browse the page in incognito mode (or privacy mode) even use different devices (such as mobile phones, tablets) for verification to ensure that the new image displays normally worldwide.

Through understanding these cache mechanisms and their corresponding cleaning methods, you will be able to manage the image resources of the AnQiCMS website more effectively, ensuring that each content update is presented to the user in a timely and accurate manner.

Common Questions (FAQ)

Q1: Why does the file size change after replacing the image, but the URL address of the image remains the same? A1:AnQiCMS will usually keep the URL path of the image unchanged when you replace the image, which is beneficial for SEO and the stability of links.However, the system will replace the old file on the server with the new image file you upload.If the size, compression rate, or conversion to WebP format of the new image is different from the old image, the actual file size and content will change even though the URL is the same.This is why it is necessary to clear the cache, so that the browser and server can request new file content again.

Q2: My website does not use CDN, why are the images still not displaying the latest version? A2:Even without CDN, the main reason is still your local browser cache.The browser will save the images you have visited locally to accelerate access.When you replace the image but the URL does not change, the browser will consider that this image has not been updated and directly load the old cached image locally.In addition, if your web server (such as Nginx, Apache) is configured with caching, old images may also be cached on the server side, and you need to resolve this by clearing the AnQiCMS system cache or reloading the web server.

Q3: I replaced a large number of images in bulk, do I need to refresh the cache one by one? A3:Generally, it is not necessary to refresh individually.For browser cache, users can perform a hard refresh or clear the cache manually.For CDN, many CDN service providers offer batch refresh features, allowing you to specify a directory or the entire site for refreshing.For AnQiCMS system internal cache, click the 'Update Cache' button in the background to clear the entire site cache.The web server cache on the server side is also usually applied to new files through a single reload operation.Therefore, it is generally adopted to take systematic rather than piecemeal operations.