Черновики документации

Обсуждаем разработку фреймворка: дизайн компонентов, API, пакеты
Аватара пользователя
samdark
Администратор
Сообщения: 9187
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Черновики документации

Сообщение samdark » 2019.06.30, 20:11

Несмотря на то, что разработка в самом разгаре, я понемногу пишу доку.

https://github.com/yiisoft/docs/tree/master/guide/en

Аватара пользователя
Антон Смирнов
Сообщения: 284
Зарегистрирован: 2011.07.08, 10:37
Контактная информация:

Re: Черновики документации

Сообщение Антон Смирнов » 2019.06.30, 23:03

https://github.com/yiisoft/docs/blob/ma ... t/hello.md - это просто жесть для Hello Word на Yii, нет смысла переходить на этот фарш Yii3. Вы явно наслушались умников и свернули не туда.

urichalex
Сообщения: 962
Зарегистрирован: 2015.08.07, 11:03

Re: Черновики документации

Сообщение urichalex » 2019.06.30, 23:35

Антон Смирнов писал(а):
2019.06.30, 23:03
https://github.com/yiisoft/docs/blob/ma ... t/hello.md - это просто жесть для Hello Word на Yii, нет смысла переходить на этот фарш Yii3. Вы явно наслушались умников и свернули не туда.
Поддерживаю. Нужно продолжать писать в стиле DLE

Аватара пользователя
samdark
Администратор
Сообщения: 9187
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Черновики документации

Сообщение samdark » 2019.07.01, 11:48

Антон Смирнов, пока это даже не альфа, так что фарш, да. И естественно, мы видим что это фарш и в таком виде это в релиз не уйдёт. Если есть идеи как сделать лучше и при этом не убить нормальную тестируемость — пишите обязательно.

urichalex, что такое DLE?

Аватара пользователя
S c
Сообщения: 875
Зарегистрирован: 2012.04.11, 14:46

Re: Черновики документации

Сообщение S c » 2019.07.01, 11:50

samdark писал(а):
2019.07.01, 11:48
urichalex, что такое DLE?
полагаю это была шутка про DataLife Engine

Аватара пользователя
samdark
Администратор
Сообщения: 9187
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Черновики документации

Сообщение samdark » 2019.07.01, 15:33

С ним не знаком. К сожалению или же к счастью — не знаю.

Аватара пользователя
Антон Смирнов
Сообщения: 284
Зарегистрирован: 2011.07.08, 10:37
Контактная информация:

Re: Черновики документации

Сообщение Антон Смирнов » 2019.07.01, 16:05

samdark писал(а):
2019.07.01, 11:48
Антон Смирнов, пока это даже не альфа, так что фарш, да. И естественно, мы видим что это фарш и в таком виде это в релиз не уйдёт. Если есть идеи как сделать лучше и при этом не убить нормальную тестируемость — пишите обязательно.
Мне все равно, если Васю трясет от отсутствия SOLID, а Петю штормит от отсутствия "нормальной тестируемости", если переход Yii2 > Yii3 сильно снизит скорость разработки, то лично мне он не нужен. Понятно, что вам решать, да и не встань вы у руля в момент ухода Кванга, Yii утонул бы

Аватара пользователя
samdark
Администратор
Сообщения: 9187
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Черновики документации

Сообщение samdark » 2019.07.01, 17:31

Не должен снизить в итоге.

urichalex
Сообщения: 962
Зарегистрирован: 2015.08.07, 11:03

Re: Черновики документации

Сообщение urichalex » 2019.07.01, 18:11

S c писал(а):
2019.07.01, 11:50
samdark писал(а):
2019.07.01, 11:48
urichalex, что такое DLE?
полагаю это была шутка про DataLife Engine
Именно ;-)

Аватара пользователя
ElisDN
Сообщения: 5419
Зарегистрирован: 2012.10.07, 10:24
Контактная информация:

Re: Черновики документации

Сообщение ElisDN » 2019.07.01, 21:16

Антон Смирнов писал(а):
2019.06.30, 23:03
https://github.com/yiisoft/docs/blob/ma ... t/hello.md - это просто жесть для Hello Word на Yii, нет смысла переходить на этот фарш Yii3. Вы явно наслушались умников и свернули не туда.
Да уж... Кардинальный подход.

Аватара пользователя
BrusSENS
Сообщения: 565
Зарегистрирован: 2012.07.26, 06:51
Откуда: Новороссийск
Контактная информация:

Re: Черновики документации

Сообщение BrusSENS » 2019.07.02, 00:11

Антон Смирнов писал(а):
2019.06.30, 23:03
https://github.com/yiisoft/docs/blob/ma ... t/hello.md - это просто жесть для Hello Word на Yii, нет смысла переходить на этот фарш Yii3. Вы явно наслушались умников и свернули не туда.
Что за бред, всегда было в доке "Говорим привет".


Samdark, русскоязычные переводы планируются? Было бы не плохо иметь к релизу. Готов поучаствовать.
Native Web - небольшой блог о веб разработке (временно на ремонте)
Режим обслуживания сайта для Yii 2.x.x

dimsog
Сообщения: 7
Зарегистрирован: 2019.07.02, 12:29

Re: Черновики документации

Сообщение dimsog » 2019.07.02, 12:38

Специально зарегистрировался, чтобы написать.
Из крайности в крайность.

AppRouterFactory это жесть. Зачем так усложнять, если есть прекрасный подход в том же Symfony с routes.yaml и в Laravel с routes/web.php
Для ООПешнутых можно оставить этот подход, остальным дать возможность настраивать роутинг с помощью конфиг файлов, аннотаций или в контроллере делать метод routes(), где прописать роутинг.

Аватара пользователя
samdark
Администратор
Сообщения: 9187
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Черновики документации

Сообщение samdark » 2019.07.02, 14:22

BrusSENS, да, как основная дока будет написана, стартанём переводы.

Аватара пользователя
samdark
Администратор
Сообщения: 9187
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Черновики документации

Сообщение samdark » 2019.07.02, 14:23

dimsog, так и планируется. См. viewtopic.php?f=38&t=51250#p248937

Аватара пользователя
ElisDN
Сообщения: 5419
Зарегистрирован: 2012.10.07, 10:24
Контактная информация:

Re: Черновики документации

Сообщение ElisDN » 2019.07.02, 16:34

dimsog писал(а):
2019.07.02, 12:38
AppRouterFactory это жесть. Зачем так усложнять, если есть прекрасный подход в том же Symfony с routes.yaml и в Laravel с routes/web.php
Для ООПешнутых можно оставить этот подход, остальным дать возможность настраивать роутинг с помощью конфиг файлов, аннотаций или в контроллере делать метод routes(), где прописать роутинг.
Да и по контроллерам взяли бы пример с текущих Slim/Laravel/Symfony, где можно делать по желанию как контроллеры в стиле фреймворка, так и хэндлеры в стиле PSR.

Аватара пользователя
samdark
Администратор
Сообщения: 9187
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Черновики документации

Сообщение samdark » 2019.07.02, 16:50

Эта часть пока не доделана до конца. Ближе к альфе попробуем сделать что-то на фреймворке и, если будет неудобно с PSR-стиля контроллерами, прикрутим обёртку.

dimsog
Сообщения: 7
Зарегистрирован: 2019.07.02, 12:29

Re: Черновики документации

Сообщение dimsog » 2019.07.02, 17:19

Лично мне нравится подход с роутингом в Laravel. Не знаю, как для других, но я готов вручную писать конфиг роутинга, пусть он будет в yaml, php array или прости господи в xml, не важно. Главное, чтобы он был управляемым и прозрачным.

В этом плане я одновременно любил и ненавидел Yii2, за его полуавтоматический роутинг :)

Я даже буду за, если будет что-то вроде такого:

Код: Выделить всё

<?php
namespace App\Controllers;

class HelloController
{
	public function sayHello()
	{
		return new Response("Hello world!"); // а еще лучше просто return "Hello World!"
	}

	public function routes()
	{
		return [
			'/say-hello' => 'sayHello'
		];
	}
}
?>
Подход что-то между аннотациями в Symfony и array-orientired programming из Yii2, к которому многие из-за createObject(), behaviors(), etc привыкли :)

Александр, не знаю - поймете мою мысль или нет, но я напишу.

Я в свое время немного поработал с Yii1 и плотно работал на Yii2. Я примерно представляю людей, которые пишут на Yii2. Не зря для этих людей даже архив был yii-basic.tar.gz :), который уже содержал папку vendor.

PSR хорошо, но пусть он будет внутри. Простите, но Yii2 это хуяк-хуяк и в продакшн, Здесь скорость стоит на первом месте. И Yii2 был прекрасным инструментом, но монолитным. От Yii3 требуется все тоже самое, только компонентный подход. Я кстати вам в блоге писал, когда там QueryBuilder будет отдельно от фреймворка. Я до сих пор считаю, что он лучше, чем QueryBuilder из Laravel.

Если убиваться в каноничность, SOLID и прочее, возникнет вопрос, зачем Yii3, когда есть Symfony? Я помню, на хабре, тостере и прочих ресурсах "илита" мира бекенд разработки тыкала носом за отсутствие PSR. Так добавьте им PSR. Пусть они в своем серпентарии сожрут друг-друга. После выхода Yii3 c PSR они начнут ныть, что Yii3 полностью следует SOLID и компонентному подходу, но зачем он нам нужен, если есть Symfony. Вот так и будет 100%.

И да, мне кажется или Yii3 это попытка сделать конкурента Symfony, когда нужно отбирать рынок у Laravel?

Аватара пользователя
samdark
Администратор
Сообщения: 9187
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Черновики документации

Сообщение samdark » 2019.07.02, 17:59

Я в свое время немного поработал с Yii1 и плотно работал на Yii2. Я примерно представляю людей, которые пишут на Yii2. Не зря для этих людей даже архив был yii-basic.tar.gz :), который уже содержал папку vendor.
Это лишь часть людей. Если посмотреть на проекты с того же https://yiipowered.com/ru, становится понятно, что фреймворк как-бы подходит не только для хренак-хренак и супер-простых проектов.
Простите, но Yii2 это хуяк-хуяк и в продакшн
Он позволяет так делать, но это не значит что он не позволяет делать нормально. Ну почти. С тестированием не вполне всё приятно и вот ради него, в основном, такое глобальное перетряхивание и делается.
Если убиваться в каноничность, SOLID и прочее, возникнет вопрос, зачем Yii3, когда есть Symfony? Я помню, на хабре, тостере и прочих ресурсах "илита" мира бекенд разработки тыкала носом за отсутствие PSR. Так добавьте им PSR. Пусть они в своем серпентарии сожрут друг-друга. После выхода Yii3 c PSR они начнут ныть, что Yii3 полностью следует SOLID и компонентному подходу, но зачем он нам нужен, если есть Symfony. Вот так и будет 100%.
При чём тут Symfony? Мы решаем изменениями конкретные и достаточно фундаментальные проблемы в Yii 2, а не пытаемся удовлетворить "илиту" или стать Symfony.

Вопросы из разряда "зачем PHP когда есть Golang", "зачем Symfony когда есть Spring" и подобные не особо волнуют. У Yii 3 достаточно концептуальных отличий чтобы занять нишу.
И да, мне кажется или Yii3 это попытка сделать конкурента Symfony, когда нужно отбирать рынок у Laravel?
Кажется. Yii 3 — попытка устранить глубокие косяки Yii 2. Удобство приедет чуть позже.

Аватара пользователя
Антон Смирнов
Сообщения: 284
Зарегистрирован: 2011.07.08, 10:37
Контактная информация:

Re: Черновики документации

Сообщение Антон Смирнов » 2019.07.03, 11:41

samdark писал(а):
2019.07.02, 17:59
Кажется. Yii 3 — попытка устранить глубокие косяки Yii 2. Удобство приедет чуть позже.
Вам не кажется, что это борьба с ветряными мельницами? Косяки всегда есть и будут только про причине того, что сколько людей, столько и мнений. Скажу про себя - у меня хорошее знание Yii1 и Yii2, много проектов сделано, разной нагрузки и направленности. И мне реально нечего предьявить Yii, все устраивает, когда перешел на Yii2, то я получил кучу плюшек, не потеряв скорости. И в Yii не только скорость ценится, но и гибкость, сколько раз сталкивался с коллегами на Laravel, там далеко не так все гибко.

Аватара пользователя
samdark
Администратор
Сообщения: 9187
Зарегистрирован: 2009.04.02, 13:46
Откуда: Воронеж
Контактная информация:

Re: Черновики документации

Сообщение samdark » 2019.07.03, 12:10

Есть мнения, а есть объективная реальность.

То что тесты в проектах на Yii 2 писать сложнее, чем, например, в проектах на Symfony (много моков) — факт. Что приходится писать обёртки чтобы нормально использовать просто PHP-библиотеку с Yii 2 — чаще да, чем нет. Вот это мы и исправляем.

PSR вводится не ради моды, а чтобы можно было переиспользовать, например, HTTP-слой и получить плюшку в виде возможности запуска под RoadRunner или Swoole из коробки. Ну и чтобы не писать своё когда есть отличные либы вроде nyholm/psr7.

Скорость мы, думаю, сумеем не потерять значительно. Гибкость будет сильно выше.

Ответить