- Issue created by @kevinb623
- π¦πΊAustralia dpi Perth, Australia
The motivation is good, however the implementation needs work
- Status changed to Needs work
12 months ago 6:01am 26 June 2024 - First commit to issue fork.
- πͺπΈSpain omarlopesino
This issue is really interesting, thanks for the contribution @kevinb623 . Supporting queues may drastically improve the performance when there are too many URLs to purge.
Also many thanks for helping reviewing @dpi, it saved me time.
The most priority changes needed to merge this are:
- Make form labels translatable
- Hook install to configure existing sites.
- Coding standards must pass, Currently, this module is integrated with Gitlab CI to help on this purpose.
- Ideally, applying every suggestion mentioned in the feedback.
- πͺπΈSpain jonhattan Plasencia
I thing this is going the wrong direction. Purge API is not being used the right way by the module and thus, by this MR.
Some things I've seen so far:
With respect to the general module implementation
1. The user should not need to choose a processor
Choosing a processor is useless. Despite the processor, it will purge files on the fly when invoking the hook in the middle of the request (not on cron, not on late runtime). Purge's invalidate() requires a processor indeed, but it is not used at all. See https://git.drupalcode.org/project/purge/-/commit/a3632d03ee72b0a09aa1b2...
Instead of processing invalidations on the fly, it should rely on a queue and the system-wide configured processor. Otherwise, on any failure, we're exposed to lose pending invalidations since they're not tracked.
If immediate purge were necessary for some reason, it could be opt-in in the module configuration. This should show a warning message, and not rely on the user choosing a processor, but passing invalidate() any of the enabled processors since it is a required parameter although useless.
2. The module should warn and inhibit, if no
url
(orwildcardurl
) invalidator processor is available.It passes silently if no compatible invalidator is enabled.
With respect to this MR
1. Purge queue is mandatory in purge configuration.
No need to choose a queue.
2. To enqueue items implement a PurgeQueuer plugin and use @purge.queue service
There's an implementation easy to follow in this module: https://git.drupalcode.org/project/url_purge_aggregator/-/tree/1.x/. See https://git.drupalcode.org/project/url_purge_aggregator/-/blob/1.x/url_p...
- πΊπΈUnited States recrit
@jonhattan Regarding "Purge API is not being used the right way by the module and thus, by this MR.", that is your opinion.
The settings form for the purge_file module follows what would be expected by a Drupal contrib module that implements a plugin system - select a plugin that affects the system. However, the purge module's plugins actually do not do anything other than provide labels for log messages. For example - In\Drupal\purge\Plugin\Purge\Queue\QueueService::add(QueuerInterface $queuer, array $invalidations)>code>, the <code>$queuer
argument is meaningless and is only used for the log message.public function add(QueuerInterface $queuer, array $invalidations) { foreach ($invalidations as $invalidation) { if (!$this->buffer->has($invalidation)) { $this->buffer->set($invalidation, TxBuffer::ADDING); } } $this->logger->debug("@queuer: added @no items.", [ '@queuer' => $queuer->getPluginId(), '@no' => count($invalidations), ]); }
Another example is the processor plugin. The purge module's own submodule
purge_processor_cron
implements its own hook_cron and then just passes the "cron" plugin to\Drupal\purge\Plugin\Purge\Purger\PurgersService::invalidate(ProcessorInterface $processor, array $invalidations)<code> which the <code>$processor
argument is never used, any code validation would detect it as "unused".Any plugin for the purge module's system does not do anything without additional custom code.
So one might ask the alternate question - why does the purge module even have plugins? - Merge request !10Issue #3400166: Add support for queueing invalidations using the Purge plugins and API β (Open) created by recrit
- πΊπΈUnited States recrit
I created a new branch
3400166-use-purge-api
(MR 10) that extends the original updates in MR 6 and refactors to use the purge plugins and API.- Implements its own purge plugins for a queuer and processor
- There is only a selection for the new "Workflow", eliminating the selection for a queuer and processor since that is no longer needed.
- Added warnings on the settings page and status report regarding supported URL purgers.
- Updated the module code to support the new workflows.
- Added an update function to convert the old configuration to the new configuration
Attached is a static patch of MR10 for composer builds.