Download the PHP package neooblaster/syslang without Composer

On this page you can find all versions of the php package neooblaster/syslang. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of neooblaster/syslang

Informations about the package syslang

Moteur de langue SYSLang

pipeline status coverage report

build status coverage report

Sommaire

SYSLang :: Interface CLI

Options transversales

Installation

Dossier de travail

L'outil de ligne de commande accepte comme option transversable --directory (--dir) qui sert à l'ensemble des commandes pour définir le dossier de travail. Si l'option est omise, le dossier de travail est le dossier courant dans lequel est exéxutée la commande.

Mode silencieux

Par défaut, l'outil est configuré pour être verbeux. Si vous ne souhaitez pas recevoir de messages d'informations il suffit d'ajout l'option --silent.

Installation de l'environnement

Pour rendre le dossier de travail comme étant système de langue SYSLang, il suffit de taper la commande suivante :

Enregistrer des nouvelles langues au registre

L'installation n'inclus aucune langue dans le registre et donc ne défini pas de langue par défaut. L'enregistrement de la première langue définiera également celle-ci comme étant langue par défaut.

Pour enregistrer une langue, celle-ci doit être au format xx-XX:NomDeLaLangue où

Exemples :

L'option permettant l'enregistrement d'une langue est --add-languages.

L'option admet un ou plusieurs couple xx-XX:Name et doivent être séparés par une virgule (,).

Supprimer des langues du registre

Il est possible de supprimer une langue (ou plusieurs) du registre.

Pour supprimer une langue du registre, il suffit de spécifier son code de langue au format xx-XX à l'option --remove-languages (--remove-langs).

L'option admet une ou plusieurs valeurs xx-XX et doivent être séparés par une virgule (,).

Important : Lorsque la langue par défaut est supprimée du registre, une nouvelle est définie automatiquement par le programme.

Définir la langue par défaut

Si la langue par défaut définie ne convient pas, il suffit de modifier celle-ci à l'aide de l'option suivante --set-default-lang. Elle accepte comme valeur, le code de langue au format xx-XX.

Il est impossible de définir une langue non enregistrée comme langue par défaut.

Mise à jour des langues enregistrées

Lors des évolutions, les fichiers de langue sont amenés à évoluer. Certain texte peut avoir changé, il peut y avoir eu des ajouts et même des suppressions. Plus il y a de langues enregistrées, plus la maintenance devient impossible manuellement.

Pour répondre à ces besoins, le moteur SYSLang dispose de fonctionnalités permettant cette maintenance.

L'option qui permet cette maintenance est --deploy. Cette maintenance sera effectuée en se référant à la langue par défaut définie dans le fichier de configuration languages.xml.

Si la langue définie par défaut, n'est pas la langue de référence pour vos développements, il est possible de spécifier la langue de référence à l'aide de l'option --from xx-XX.

Par exemple, votre application définie l'anglais comme langue par défaut, mais que vous faites vos développements via la langue française, il faudra donc maintenir l'ensemble des langues enregistrées via la commande suivante :

Exportation des textes sous une forme simplifiée (INI).

Pour simplifier l'operation de traduction, j'ai décidé de sortir les textes de leur structure XML et de les présenter plus simplement dans un fichier .INI. Les traducteurs n'ont plus qu'à se concentrer sur la traduction des textes qui se trouvent dans l'ensemble INI [TEXTS].

Pour passer du format XML au format INI, j'ai donc créé l'option --export.

Si cette option est utilisée seule, l'exportation est effectuée dans le dossier exports là où le système est installé.

Important: Seul les textes ayant besoin d'être traduit sont exportés. S'il n'y a aucune information concernant ce besoin de traduction, alors il sera exporté.

Si vous souhaitez dans tous les cas tout exporter, alors il faut ajouter l'option --complete.

Il est possible de spécifier un dossier cible pour l'exportation à l'aide de l'option --export-dir. Si vous utilisez un chemin relatif, celui-ci sera relatif par rapport à l'emplacement du système et non pas de l'endroit où vous vous trouvez.

Si vous spécifiez un chemin absolu, celui-ci partira donc comme prévu depuis l'emplacement root / du système d'exploitation.

Importation des textes à partir de fichiers .INI.

Une fois les traductions faites, il ne reste plus qu'à procéder à l'importation pour mettre à jour les différents fichiers XML.

L'option pour effecuter cette importation est --import.

Si cette option est utilisée seule, l'importation est effectuée depuis le dossier imports là où le système est installé.

Il est possible de spécifier un dossier source pour l'importation à l'aide de l'option --import-dir. Si vous utilisez un chemin relatif, celui-ci sera relatif par rapport à l'emplacement du système et non pas de l'endroit où vous vous trouvez.

Si vous spécifiez un chemin absolu, celui-ci partira donc comme prévu depuis l'emplacement root / du système d'exploitation.

Important : Par défaut, le système d'importation détruit les fichiers traités.

Il est possible de demander au système de conserver ces fichiers via l'option --preserve-files.

Le système de maintenance des textes de manière "différentielle". En effet, la maintenance des textes étant faite depuis une langue de référence, écraser les traductions existantes rajouterais du travail aux contributeurs.

C'est pour cette raison que le système dispose d'un attribut indiquant s'il faut ou non effectuer une opération de traduction. Cet attribut est TIR pour Translation Is Required.

Une opération de traduction est nécessaire si le texte a changé ou si un texte a été ajouté.

Une fois que la traduction effectuée est importée, si le résultat est conforme aux attentes, alors il faut demander au système de finaliser cette importation.

Ceci se fait à l'aide de l'option --finalize. Cela aura pour effet de mettre les attributs TIR à false.

Ainsi les prochaines extractions INI contiendrons uniquement les textes ayant besoin d'être traduit. Je rappelle que le couple d'options --export --complete permet de tout extraire.

Pour finaliser l'importation, il faut donc effectuer la commande suivante.

Pour le fun, une commande relativement complète.

SYSLang :: Sous PHP

Avant d'effectuer des opérations avec le moteur sous PHP, il y à deux façons de l'instancier :

Dans l'ensemble de la documentation 'sous PHP', j'utiliserais la variable $core étant l'instanciation de la classe Core en suivant l'une de ces deux méthodes. Les résultats étant évidemment le même en terme d'utilisation.

Installation de l'environnement

Pour rendre le dossier de travil courant comme étant un système de langue SYSLang, il suffit d'exécuter l'instruction suivante :

Enregistrer des nouvelles langues au registre

L'installation n'inclus aucune langue dans le registre et donc ne défini pas de langue par défaut. L'enregistrement de la première langue définiera également celle-ci comme étant langue par défaut.

Pour enregistrer une langue, celle-ci doit être au format xx-XX:NomDeLaLangue où

Exemples :

La méthode addLanguages admet autant d'arguments xx-XX:NomDeLaLangue que vous voulez.

Supprimer des langues du registre

Il est possible de supprimer une langue (ou plusieurs) du registre.

Pour supprimer une langue du registre, il suffit de spécifier son code de langue au format xx-XX à la méthode removeLanguages. Il faudra d'abord indiqué si vous voulez concerver les fichiers de langue dans le dossier courant ($preverveFiles).

La méthode admet autant d'arguments xx-XX que vous voulez.

Important : Lorsque la langue par défaut est supprimée du registre, une nouvelle est définie automatiquement par le programme.

Définir la langue par défaut

Si la langue par défaut définie ne convient pas, il suffit de modifier celle-ci à l'aide de la méthode setDefaultLanguage. Elle accepte comme valeur, le code de langue au format xx-XX.

Il est impossible de définir une langue non enregistrée comme langue par défaut.

All versions of syslang with dependencies

PHP Build Version
Package Version
Requires php Version >=5.6
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package neooblaster/syslang contains the following files

Loading the files please wait ....