Guía de actualización - instalación clásica de TYPO3 con enlaces simbólicos

Pueden producirse errores extraños en cualquier momento y, si las cosas van mal, hacer que el backend sea inaccesible desde el principio. Para obtener al menos alguna información sobre la solución de problemas, es mejor activar primero la depuración:

Vaya al módulo "Herramientas de administración">"Configuración" y seleccione "Preajustes de configuración". En "Ajustes de depuración" puedes cambiar la configuración de "En vivo" a "Depuración".

Para evitar que la copia del sitio web sea escaneada por robots durante la actualización y aparezca en los resultados de los motores de búsqueda, debe almacenarse la instrucción correspondiente. Puede hacerlo a través de TypoScript

page.meta.robots = noindex, nofollow
page.meta.robots.replace = 1

o bien, si ya existe un archivo "robots.txt", introduzca allí lo siguiente:

User-agent: *
Disallow: /

Vaya al módulo "Extensiones" del backend y seleccione "Obtener extensiones" en el menú de la parte superior izquierda. A continuación, haga clic en el botón "Actualizar ahora" a la derecha. Se cargará una lista actualizada de todas las extensiones disponibles en el TYPO3 Extension Repository (TER). (Si la tarea del programador "Actualizar lista de extensiones (extensionmanager)" está activa en su sitio web, este proceso de actualización se llevará a cabo automáticamente en el intervalo definido).

Si ahora vuelve a "Extensiones instaladas" en el menú superior izquierdo, verá un icono de actualización a la izquierda de cada extensión instalada, siempre que exista una versión más actualizada. Actualice cada extensión a la versión más alta posible que se ofrezca.

Si aparece un mensaje de error después de actualizar una extensión y ya no es posible acceder a la lista de extensiones, también puede desactivar la extensión en cuestión a través de la línea de comandos. Para ello, vaya al directorio typo3conf, abra el archivo "PackageStates.php" para editarlo y elimine la sección que pertenece a la extensión en cuestión. A continuación, elimine la caché borrando el directorio typo3temp/var. Ahora se debería poder acceder de nuevo al backend o a la lista de extensiones. La extensión desactivada también puede permanecer en este estado por el momento; es posible que pueda reactivarla sin problemas tras un paso de versión.

Si hay extensiones en la lista que no son compatibles con la próxima versión principal de TYPO3, desactívelas. Desactive también todas las extensiones individuales y paquetes de sitio que no estén disponibles en el TER, ya que lo más probable es que tengan que ser revisados después del siguiente paso de versión principal.

Una vez actualizadas las extensiones, es posible que haya nuevos asistentes de actualización que deban ejecutarse. Por lo tanto, vaya al módulo "Herramientas de administración" > "Actualización" y haga clic en "Ejecutar asistente de actualización". Los asistentes que siguen abiertos aparecen ahora en una lista con una breve descripción. Ejecute todos los asistentes. Si se le pregunta si realmente desea ejecutar este asistente y no está seguro, seleccione previamente "no, no ejecutar" y haga clic en "Ejecutar actualizaciones". El asistente no se ejecutará, pero se marcará como "completado".

Una vez ejecutados los asistentes de actualización: En el módulo backend "Herramientas de administración">"Mantenimiento", en "Analizar la estructura de la base de datos", todas las tablas y campos de la base de datos deben estar actualizados y deben eliminarse los que ya no sean necesarios.

El índice debe actualizarse en el módulo backend "Sistema">"Comprobación de BD" en "Gestionar índice de referencia".

Para actualizar, debe iniciar sesión en el servidor de nuevo a través de la línea de comandos. Busque en el directorio typo3cms para ver si ya existe un directorio o un archivo .tar.gz con la versión de TYPO3 que necesita. El nombre debería ser: typo3_src-x.x.xx, o typo3_src-x.x.xx.tar.gz.

Si la versión aún no está disponible, puede descargarla en el directorio con

wget --content-disposition https://get.typo3.org/x.x.x

A continuación, debe descomprimir el archivo descargado con

tar -zxvf typo3_src-x.x.xx.tar.gz

Ahora cambie al directorio de su proyecto y adapte el enlace simbólico typo3_src existente o bórrelo y cree uno con el mismo nombre con el nuevo directorio typo3_src-x.x.xx como destino:

rm typo3_src
ln -s ../typo3_src-x.x.xx typo3_src

A continuación, elimine la caché borrando el directorio typo3temp/var.

A continuación, acceda directamente a la herramienta de instalación con la URL v12.meine-website.de/typo3/install.php y siga los siguientes puntos en este orden:

• Ejecute los asistentes de actualización.
• Borre la caché de TYPO3 y PHP (en el módulo backend "Maintanance" > "Flush TYPO3 and PHP Cache").
• Ejecute Analizar la estructura de la base de datos. Asegúrese de añadir y modificar todas las tablas y campos nuevos, pero no elimine ninguna tabla ni campo. Recuerde que ha desactivado temporalmente extensiones que pueden necesitar estas tablas de nuevo más tarde cuando se activen.
• Conéctese ahora al backend y compruebe si aparece algún mensaje de error, por ejemplo, al consultar la lista de extensiones.
• Actualice las extensiones (incluidas las desactivadas) a la versión más alta posible para esta versión de TYPO3. Siempre tenga en cuenta hasta qué versión de TYPO3 la extensión respectiva sigue siendo compatible. Si ya no existe una versión funcional de esta extensión para la versión de TYPO3 a la que desea actualizar en el siguiente paso, desactívela.
• Compruebe si se han añadido nuevos asistentes de actualización después de actualizar las extensiones.
• No se desanime si los plugins o elementos de contenido no se pueden encontrar debido a extensiones desactivadas o paquetes de sitio o si aparece un mensaje de error en el frontend. Puede ocuparse de ello una vez alcanzada la versión de destino.

Repita el paso "Actualizar a una versión intermedia o a la versión de destino" hasta que haya alcanzado la versión de destino. En cada paso, asegúrese de que la versión de TYPO3 que acaba de alcanzar sigue funcionando con la versión PHP de su dominio y ajústela si es necesario.

Aquí es donde se vuelve muy individual, ya que depende de lo que el inicio y la versión de destino de TYPO3 es y donde su paquete de sitio se encuentra actualmente o si hay uno en absoluto. Así que aquí están algunas informaciones básicas y consejos sobre cómo proceder:

• Si el paquete de sitio o plantilla de diseño se encuentra en un directorio por debajo de fileadmin, debe moverlo al directorio typo3conf/ext a partir de la versión 11 de TYPO3 como muy tarde. Puede encontrar información sobre cómo crear un paquete de sitio para TYPO3 en este directorio y luego instalarlo como una extensión en la lista de extensiones en https://docs.typo3.org/m/typo3/tutorial-sitepackage/main/en-us/.
• Para adaptar un paquete de sitio existente a la nueva versión de TYPO3, siga también el tutorial mencionado anteriormente y compruebe los archivos
  • composer.json
  • ext_emconf.php
  • ext_localconf.php
  • ext_tables.php
  • Configuración/TCA/Overrides/sys_template.php
  • Configuración/TCA/Overrides/pages.php
  • Configuración/TCA/Overrides/tt_content.php
  • y otros archivos PHP
• Compruebe si las condiciones TypoScript utilizadas siguen funcionando. A partir de TYPO3 9.4, la sintaxis de las condiciones se basa en el Lenguaje de Expresión Symfony, por lo que la sintaxis antigua tiene que ser reescrita en la nueva sintaxis en muchos lugares. Los problemas con las condiciones pueden reconocerse por una entrada correspondiente en el archivo de registro (directorio typo3temp/var/log).
• Los ViewHelpers utilizados en el Paquete de Sitio también tienen que ser adaptados o reemplazados después de una actualización porque ya no existen en la nueva versión. Puede reconocerlo por el correspondiente mensaje de error en el frontend.

Si ha adaptado completamente el paquete de sitio (u otras extensiones individuales) a la nueva versión de TYPO3, puede reactivarlo, comprobar si todo funciona y realizar más ajustes si es necesario.

Las extensiones del TER que se desactivaron durante el proceso de actualización ahora también se pueden reactivar.

Tanto el backend como el frontend deberían volver a funcionar sin problemas.

En el archivo LocalConfiguration.php o settings.php o en el InstallTool en "GFX", ajuste el valor para 'processor_colorspace' como sigue:

processor_colorspace' => 'sRGB'

Luego vacíe los directorios en el InstallTool bajo "Maintanance > Remove Temporary Assets" de donde provienen las imágenes que son demasiado oscuras.

• Cambiar la versión de PHP a >= 8.1
• en los archivos PHP la constante 'TYPO3_MODE

  if (!defined('TYPO3_MODE')) { die('Acceso denegado.'); }

  cambiar a 'TYPO3

  if (!defined('TYPO3')) { die('Acceso denegado.'); }

• Cambiar la versión de PHP a >= 7.4
• Adapte el archivo .htaccess, por ejemplo, utilice el archivo de ejemplo de TYPO3 11 Core: typo3/sysext/install/Resources/Private/FolderStructureTemplateFiles/root-htaccess
• Cambie el nombre de la extensión de los archivos Typoscript y TSConfig de .txt a .typoscript y .tsconfig respectivamente.
• sustituir la variable $_EXTKEY en los archivos PHP por el nombre del directorio del paquete del sitio (excepto en el archivo "ext_emconf.php")

TYPO3 7.6 introdujo nuevos elementos de contenido con fluid_styled_content, que se basan en plantillas fluidas. Aunque css_styled_content sigue estando disponible opcionalmente en TYPO3 8, se eliminará definitivamente en TYPO3 10. El cambio significa que el contenido ya no se emite a través de estructuras HTML estáticas con plantillas Typoscript, sino a través de modernas plantillas fluidas, que son más flexibles, ampliables y fáciles de mantener. Una migración temprana merece la pena, ya que no sólo facilita futuras actualizaciones, sino que también permite el uso de nuevas funciones como datos estructurados, diseños responsivos o etiquetado sin barreras. La migración debe completarse en TYPO3 9 LTS a más tardar, ya que css_styled_content ya no está disponible en TYPO3 10 LTS.

Si utiliza subtítulos y/o marcadores en sus plantillas, éstos deben ser convertidos a plantillas Fluid. Lo mismo se aplica si está utilizando una extensión obsoleta como templavoila, rlmp_tmplselector o automaketemplate para la creación de plantillas.