Releases 12.1 

!!! Upgrade to Apache Solr 9.10.1 

Apache Solr 9.10.1 fixes several security issues, please upgrade your Apache Solr instance!

• CVE-2025-54988: Apache Solr extraction module vulnerable to XXE attacks via XFA content in PDFs
• CVE-2026-22444: Apache Solr: Insufficient file-access checking in standalone core-creation requests
• CVE-2026-22022: Apache Solr: Unauthorized bypass of certain "predefined permission" rules in the RuleBasedAuthorizationPlugin

New in this release 

Key Highlights 

1. Initial Vector Search Introduction:

   • The EXT:solr version 12.1 and 13.1 introduces an initial vector search option as a new search variant.
   • Activating this feature automatically generates vectors during indexing and frontend search.
   • A connected large language model (LLM) is required for operation, though it is not directly related to EXT:solr.

2. Handling and Limitations of Vector Search:

   • Current implementation includes limitations, especially in error handling when required LLMs are not defined, leading to potential impairments in indexing or search.
   • Indexing without vector calculation results in documents not being found despite successful index status.
   • A missing or unavailable LLM during search attempts can lead to a SolrInternalServerErrorException, returning an HTTP status 500.

3. Configuring a Large Language Model:

   • To use vector search, a large language model must be connected to encode text into vectors.
   • Configuration details are available in the Apache Solr Reference Guide 9.9.

   • Models can be uploaded using a JSON file and cURL command.

     Example configuration for the JSON file

     {
       "class": "dev.langchain4j.model.openai.OpenAiEmbeddingModel",
       "name": "llm",
       "params": {
         "baseUrl": "https://api.openai.com/v1",
         "apiKey": "apiKey-openAI",
         "modelName": "text-embedding-3-small",
         "timeout": 5,
         "logRequests": true,
         "logResponses": true,
         "maxRetries": 2
       }
     }

     Copied!
   • The number of dimensions for vectors defaults to 768 but can be adjusted via the SOLR_VECTOR_DIMENSION environment variable.

Future Developments 

• Improved Error Handling: Future versions plan to enhance error handling during vector indexing and search to increase robustness and reliability.
• Additional Query Types: New query types such as vector sorting and vector re-ranking are planned, allowing for more advanced search result manipulation.
• Backend Module for LLM Management: A backend module for managing large language models is anticipated, simplifying maintenance and configuration for developers.

This introduction marks a significant advancement for TYPO3's search capabilities by integrating AI technologies, with ongoing improvements and features planned for future releases.

For more detailed technical implementation and setup instructions, users should refer to the version 12.1 or 13.1 release notes and the associated documentation sections.

Technical insights 

As soon as vector search is enabled, EXT:solr will use the connected LLM to generate vectors during indexing and for each search in the frontend. During indexing vectors are generated based on field vectorContent which is by default filled with the contents of the content field. TypoScript indexing configurations can be used to customize the contents of the vectorContent field, e.g.:

plugin.tx_solr.index.queue.news.fields {
  vectorContent = SOLR_CONTENT
  vectorContent.cObject = COA
  vectorContent.cObject {
    10 = TEXT
    10 {
      field = name
    }

    15 = TEXT
    15 {
      field = bodytext
    }
  }
}

During indexing vectors will be created and stored in field vector.

All Changes 

• [FEATURE] Add DenseVectorField in schemas by @dkd-kaehm in #4440
• [TASK] Prepare release-12.1.x branch by @dkd-kaehm in #4445
• [TASK] 12.1.x-dev Update solarium/solarium requirement from 6.3.7 to 6.4.1 by @dependabot[bot] in #4434
• [FEATURE] Initial vector search by @dkd-friedrich in #4447
• [TASK] 12.1.x-dev Bump solr from 9.9.0 to 9.10.0 in /Docker/SolrServer by @dependabot[bot] in #4463
• Fix bug for phrase search with slops, bigram and trigram by Florian Rival in #4472
• [BUGFIX] Pass TypoScript configuration to SolrWriteService by @dkd-friedrich in #4475
• [FEATURE] Add dateRange field type in schema by @tillhoerner in #4487
• [BUGFIX] Replace TSFE call for page type by Sebastian Klein in #4488
• [FEATURE] Improve BeforeSearchFormIsShownEvent by Simon Schaufelberger in #4486
• [FEATURE] Add HEALTHCHECK to Dockerfile by @dkd-kaehm in #4489
• !!![FEATURE] allow nested TypoScript on multiValue fields by @dkd-kaehm in #4496