Zum Inhalt springen

Actualización de TYPO3 9 LTS a 10 LTS

Utilizando nuestro proyecto de muestra como ejemplo, le mostraremos cómo actualizar a TYPO3 10 LTS.

La actualización de TYPO3 9 a 10 en realidad no es difícil. El sistema en sí normalmente se puede actualizar sin ningún problema.

Sin embargo, un problema podría ser extensiones que no son (todavía) compatibles con TYPO3 10. También hay algunos cambios que deben tenerse en cuenta, por ejemplo cuando se utiliza su propio paquete de sitio (una extensión que se utiliza para la salida del front-end).

En los siguientes vídeos, mostramos cómo actualizar a TYPO3 10 utilizando nuestro proyecto de muestra como ejemplo.

Pero lo primero es lo primero: estos videos no pueden ser una guía universal para cada proyecto TYPO3. Esto se debe a que cada proyecto puede tener sus propias "trampas" individuales que deben tenerse en cuenta.

Sin embargo, los pasos son siempre los mismos en principio.

En los vídeos se utiliza una instalación "clásica" de TYPO3 basada en enlaces simbólicos. La actualización se lleva a cabo en un paquete de alojamiento en la nube, pero por supuesto todo el asunto también funciona en el alojamiento clásico. En los vídeos señalamos diferencias significativas.

Copiar proyecto TYPO3

TYPO3 actualizaciones nunca deben llevarse a cabo en el sitio web en vivo. Aunque una actualización parezca rápida y sencilla, siempre pueden surgir complicaciones imprevistas. Para que los visitantes del sitio web no noten nada de esto, una actualización de este tipo siempre debe llevarse a cabo en una copia del sitio web. Esto permite actualizar la copia tranquilamente mientras el sitio original sigue funcionando sin verse afectado.

Una vez finalizada la actualización, la copia actualizada puede pasarse al sitio activo. Este cambio suele durar sólo unos minutos. En el mejor de los casos, los visitantes del sitio web no notarán en absoluto el proceso.

Por supuesto, es importante tener en cuenta que si durante la actualización se modifican contenidos en el sitio original, éstos deben añadirse a la copia. La sincronización posterior sólo será posible con cierto esfuerzo.

El procedimiento descrito en esta página está dirigido a los usuarios que desean actualizar su sistema TYPO3 directamente en el servidor.

Por supuesto, hay otras cosas a considerar, especialmente para instalaciones más grandes, incluso si está trabajando con un despliegue como TYPO3 Surf o Deployer. Sin embargo, no consideramos este caso de uso en estas instrucciones.

Copiar proyecto TYPO3 parte 1: Archivos

Para crear una copia del sistema TYPO3, es necesario copiar dos componentes.

  1. Los archivos del servidor
  2. La base de datos

En el siguiente vídeo le mostramos cómo copiar los archivos de una instalación TYPO3.

Copiar proyecto TYPO3 Parte 2: Base de datos

En el segundo paso, hay que crear una copia de la base de datos.

Cree un archivo de exportación (dump) de la base de datos:

mysqldump --opt -h host -u nombre de usuario -p nombre de la base de datos > database.sql

Por favor, sustituya la entrada host por el servidor de base de datos tal y como está almacenado en su menú de cliente.

La forma más fácil de encontrar los otros datos de acceso es en el archivo typo3conf/LocalConfiguration.php.

A continuación, cree una nueva base de datos a través del menú de cliente e importe el volcado a esta base de datos.

mysql -h host -u nombre de usuario -p nombre de base de datos < base de datos.sql

Por último, hay que introducir los nuevos datos de acceso a la base de datos en el archivo typo3conf/LocalConfiguration.php de la copia.

Todos los pasos se muestran en detalle en el siguiente vídeo.

Enlazar (sub)dominio con la copia

Ahora se debe vincular un dominio o subdominio al directorio del proyecto en el servidor para que se pueda acceder a la copia del proyecto en el navegador web.

En Cloud Hosting, recomendamos utilizar un subdominio, ya que la versión PHP se puede configurar independientemente del dominio principal y se puede crear un certificado SSL Lets's Encrypt gratuito para el subdominio si es necesario.

En Classic Hosting, también puede utilizar un dominio gratuito *.webseiten.cc si desea o necesita utilizar diferentes versiones de PHP.

Después de que el (sub)dominio ha sido vinculado, el llamado punto de entrada debe ser ajustado en la configuración del sitio TYPO3 para que la salida front-end del sitio web también funcione correctamente.

Comprobar proyecto, actualizar extensiones

La instalación debe comprobarse antes de la actualización propiamente dicha. ¿Funciona todo en la copia exactamente igual que en el sitio activo?

En esta fase, también debe comprobar las extensiones utilizadas. ¿Son realmente necesarias todas las extensiones activas? ¿O hay todavía algunos "cadáveres" en el sistema?

Las extensiones que no se utilicen activamente deben eliminarse por completo del sistema.

Para todas las extensiones utilizadas activamente, debe comprobar si están disponibles para la nueva versión de TYPO3. Puede que ya sea posible actualizar las extensiones en TYPO3 9 y continuar utilizándolas directamente en TYPO3 10.

Sin embargo, también hay extensiones que deben ser desactivadas temporalmente (por ejemplo, Gridelements). Las nuevas versiones de estas extensiones sólo pueden ser actualizadas y reactivadas en TYPO3 10.

Si está utilizando una extensión que no está disponible para TYPO3 10, es posible que tenga que buscar una alternativa. Tal vez hay una extensión compatible con 10 que tiene el mismo o al menos una gama similar de funciones.

En el peor de los casos, puede que tenga que ponerse en contacto con el desarrollador de la extensión y solicitar una actualización de la extensión.

Actualizar el núcleo de TYPO3

El siguiente paso es "reemplazar" el núcleo TYPO3. En una instalación basada en enlaces simbólicos, esto significa cambiar el destino del enlace simbólico al directorio del nuevo núcleo TYPO3.

A continuación, puede llamar a la herramienta de instalación a través de la dirección web

dominio.de/typo3/install.php

Es posible que ahora reciba un mensaje indicándole que debe crear un archivo llamado ENABLE_INSTALL_TOOL en el directorio typo3conf/.

Para ello, cambie a este directorio en el intérprete de comandos y cree el archivo:

cd typo3conf/
toque ENABLE_INSTALL_TOOL

Este archivo no necesita ningún contenido, simplemente tiene que existir.

A continuación, vuelva a llamar a la herramienta de instalación y debería aparecer la pantalla de inicio de sesión.

Si no conoce (o ya no conoce) la contraseña del Installtool: aquí encontrará instrucciones sobre cómo restablecer la contraseña del Installtool.

El asistente de actualización y el analizador de bases de datos pueden ejecutarse en la herramienta de instalación. También deben actualizarse los paquetes de idioma.

Por último, elimine todos los cachés y debería ver en el backend que ahora está trabajando con la última TYPO3 10.4.x.

Ajustes en el proyecto de muestra

El archivo typo3conf/ext(jwmusterprojekt9/ext_localconf.php debe ser editado para que los archivos TSconfig del proyecto de ejemplo se carguen correctamente de nuevo.

Opcional: nuevas funciones de TYPO3 10

TYPO3 10 viene con algunas nuevas funciones, por ejemplo, el tablero de instrumentos. Si estas nuevas funciones también deben ser utilizadas por los editores (es decir, los usuarios sin derechos de administración), por lo general es necesario realizar ajustes en los derechos de usuario.

Opcional: Sustituir el proyecto de ejemplo 9 por el proyecto de ejemplo 10

Toda la configuración del proyecto de ejemplo se almacena en su propia pequeña extensión, un llamado paquete de sitio. Sin embargo, esta extensión en la versión 9 (jwmusterprojekt9) no puede ser actualizada directamente a la versión 10 (jwmusterprojekt10).

Sin embargo, es posible simplemente intercambiar las extensiones.

Importante: Si usted ha hecho cambios en los archivos de la ext. jwmusterprojekt9, por ejemplo en el CSS, JavaScript o las plantillas de fluidos, estos cambios no pueden ser aplicados automáticamente. Usted tendría que transferir los cambios necesarios manualmente.

El vídeo le muestra los pasos más importantes para sustituir la extensión del proyecto de ejemplo.

Aquí encontrará documentación detallada sobre las funciones del proyecto de ejemplo 10.

Ordenar y vivir

Antes de poner en marcha la versión actualizada del sitio web, conviene "poner orden" un poco. Esto incluye, por ejemplo, eliminar extensiones que ya no se utilizan, comprobar de nuevo que la base de datos está actualizada y limpia y que el sistema funciona en modo activo.

A continuación, la nueva versión debería mostrarse a través del dominio principal.

Personalizar el script de copia de seguridad

El proyecto debería incluirse ahora en el script diario como muy tarde. Este archivo se encuentra en el directorio typo3cms/system/backup.

El script no sólo se utiliza para realizar copias de seguridad nocturnas de los proyectos allí incluidos, sino también para controlar los trabajos de mantenimiento del paquete de alojamiento o la distribución de nuevas versiones de TYPO3.

Por supuesto, las copias de seguridad también se crean automáticamente en sistemas externos, pero usted tiene acceso directo a las copias de seguridad creadas por el script diario.

El contenido de esta página se ha traducido automáticamente.

Aktualisiert: 17.07.2024