README

SIU-Toba

快速开发Web应用程序的框架

先决条件

• 需要安装Composer
• 需要安装Yarn

从头创建项目

要使用SIU-Toba从头创建项目，我们将使用GitHub上的空项目模板，建议直接从https://github.com/SIU-Toba/template-proyecto-toba下载zip文件，注意版本号。接下来，我们编辑composer.json文件，以定义将包含项目的包名称，并添加或修改项目所需包的选项。完成此步骤后，我们执行

composer install

然后，按照下面的说明继续安装SIU-Toba。

最后一步是通过以下命令创建项目本身

toba proyecto crear -p nombre_proyecto -d `pwd`

完成此步骤后，重新启动web服务器，使用浏览器访问https:///toba_editor/$nro_version$并开始构建项目。

通过composer将现有项目迁移到安装

要将现有项目迁移到SIU-Toba的新安装机制，可以采取以下两种途径

• 遵循从头创建项目的程序，然后覆盖当前项目的内容。
• 另一种选择是执行以下步骤

在项目目录内创建一个composer.json文件，其中指定该文件的数据，然后继续执行以下步骤以包含必要的存储库。

然后按照前面提到的进行SIU-Toba的安装，然后使用以下命令加载项目

toba proyecto cargar -p nombre_proyecto -d `pwd`

安装SIU-Toba

从版本3.0开始，SIU-Toba的下载完全通过composer进行，为此，必须在项目的composer.json文件中添加以下行

    "repositories": [
        {
            "type": "composer",
            "url": "https://satis.siu.edu.ar",
            "exclude": ["siu-toba/framework", "siu-toba/rest"]
        }
    ],
    "require": {
        "siu-toba/framework": "~3.3"
    },
   "scripts": {
        "post-install-cmd": [
            "composer run-script post-install-cmd -d ./vendor/siu-toba/framework/"
        ],
        "post-update-cmd": [
            "composer run-script post-install-cmd -d ./vendor/siu-toba/framework/"
        ]
    },
    "minimum-stability": "dev",
    "prefer-stable" : true

然后根据我们使用composer的方式执行实际的下载。为此，我们可以使用以下命令

composer install

或

composer update siu-toba/framework

执行这些命令后，我们继续安装SIU-Toba，首先通过以下方式定义实例名称和安装目录的变量

export TOBA_INSTANCIA=$nombre_instancia
export TOBA_INSTALACION_DIR=$carpeta_instalacion

然后，以传统方式从bin目录（如果项目存在或从toba）通过命令行启动安装（这将允许用于应用程序的开发）

toba instalacion instalar [-modificadores]

此命令是交互式的，尽管可以使用修饰符来指定所需信息的一部分（要查看修饰符列表，请键入''toba instalacion instalar --help''），默认情况下，它将尝试加载位于''vendor/siu-toba/framework/proyectos''目录中的所有项目。安装完成后，将要求您将必要的别名添加到web服务器的配置中，以便于项目导航。

对于更可脚本化的环境（如Docker容器）的另一种选择是使用以下命令

toba instalacion_silenciosa instalar [--archivo_configuracion parameters.yml]

允许完全无人值守安装，配置信息存储在YAML文件中，数据库密钥和系统管理员信息通过单独的文本文件提供。这种安装方式不会在实例中加载任何项目，因此要使用toba_editor和toba_usuario，需要额外的步骤。然而，这可能是一种很好的手动生产安装方式，因为它允许生成具有相同配置的副本。

迁移项目到新版本

要迁移项目到新版本，建议以下步骤：

• 将项目文件夹复制到一个新的目录
• 安装SIU-Toba的新版本
• 通过以下命令导入项目，指定：

toba proyecto importar -p nombre_proyecto -d dir_instalacion_anterior --destino `pwd`