Project

General

Profile

Actions

Task #88940

closed

Standard (composer) installation process in T3 v9 does not offer introduction distribution

Added by Jonas Eberle over 5 years ago. Updated over 4 years ago.

Status:
Closed
Priority:
Should have
Assignee:
-
Category:
composer
Target version:
-
Start date:
2019-08-08
Due date:
% Done:

0%

Estimated time:
TYPO3 Version:
9
PHP Version:
Tags:
Complexity:
Sprint Focus:

Description

After the initial

composer create-project typo3/cms-base-distribution

you do not get the option 'Yes, download the list of distributions' and thus no possibility to install the introduction distribution.

Shouldn't that be the absolute default? How can we pass on that possiblity to enable newbies to try out TYPO3 quickly?


On the other hand, the non-composer

wget -O - get.typo3.org/9 | tar xvzf -
ln -s typo3_src-9.5.8/ typo3_src
ln -s typo3_src/index.php
ln -s typo3_src/typo3/

gets you to 'Yes, download the list of distributions' and actually allows you to install the official introduction package.


Thus, if we want to continue on the composer-way, the installation experience for beginners should be improved.

Actions #1

Updated by Oliver Hader over 5 years ago

When using composer, "extension handling" (storage and PSR autoload handling) is delegated to composer completely. That's why in composer mode retrieving extensions from TER as ZIP to be placed in typo3conf/ext is denied - composer stores extensions to vendor directory and symlinks to typo3conf/ext instead.

Thus, using the introduction package in composer mode on command line, it's required to add that to composer.json by using

composer require typo3/cms-introduction

Actions #2

Updated by Oliver Hader over 5 years ago

Thus, the a composer install plugin would have to list available distributions (being available as composer package)...

Actions #3

Updated by Oliver Hader over 5 years ago

  • Category set to composer
  • Status changed from New to Needs Feedback
Actions #4

Updated by Jonas Eberle over 5 years ago

It needs to be

composer req typo3/cms-introduction='*'

because it will fail while trying to install the newest (only v10) otherwise.

Maybe we could advertise a newbie-friendly TYPO3 directly in the docs, https://get.typo3.org and similar pages like https://ddev.readthedocs.io/en/latest/users/cli-usage/#typo3-quickstart?

composer create typo3/cms-base-distribution=^9 . && composer req typo3/cms-introduction='*'

I am really thinking about an easier "try out TYPO3 now"-experience.
What do you think?

Actions #5

Updated by Jonas Eberle over 5 years ago

In this way the distribution installs its dependencies but does not create the example database records.

I did not find a way to run its update script otherwise through the backend - am I missing something?

So it should also be noted that one needs to deactivate/activate the introduction extension.

So to get going in the shortest time it would be:

composer create typo3/cms-base-distribution=^9 . 
composer req typo3/cms-introduction='*'

vendor/bin/typo3 extension:deactivate introduction
vendor/bin/typo3 extension:activate introduction

touch public/FIRST_INSTALL
#  then go to ..../typo3/install.php

Actions #6

Updated by Jonas Eberle over 4 years ago

As this technically not solvable with composer in the same easy fashion as without, I suggested to mention the introduction package in the "Quick Install" guide:
https://docs.typo3.org/m/typo3/guide-installation/master/en-us/QuickInstall/TheInstallTool/Index.html#the-install-tool (PR https://github.com/TYPO3-Documentation/TYPO3CMS-Guide-Installation/pull/134)

Actions #7

Updated by Susanne Moog over 4 years ago

  • Status changed from Needs Feedback to Closed

Closing here for now, as I think the docs PR is enough for new users for now.

As for the database records: those should be created on first install (so "activate" on CLI should actually run these, via GUI "activate" in Extension Manager will create them).

Actions

Also available in: Atom PDF